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Preface 


This book is an in-depth guide through the process of creating a high quality game 
from scratch, starting from importing and implementing assets and ending up with 
packaging the game for release and making patches, with all the steps in-between. The 
main aim of this book is to make a game that looks awesome, and cover advanced stuff 
using C++ extensively to build the logic for the game. 


What this book covers 


Chapter 1, Preparing for a Big Project, shows how to create a new project, set it up, edit 
its settings and making it ready to rock. Also, the advanced assets pipeline will be 
discussed so that readers can bring in their models into Unreal Engine. 


Chapter 2, Setting U p Y our Warrior, explains how to make the game's hero! We will be 
building a character controller mapped to the keyboard and mouse using C+. You 
will learn how to create the logic for the character, switch weapons, attack, and move 
with C+ The class will be converted to blueprints. You will learn how to add in 
animations and physics to make it move using C+. 


Chapter 3, Designing Y our Playground, shows how to build the game world! We will 
be using the editor tools and brushes to build a level, apply lighting and materials 
to it, and make it ready for the prst round of testing the game's logic. 


Chapter 4, The Road to Thinkable Al, shows how to build the game's creatures Al, 
which are going to detect the player and attack them based on distance, sight, and/ 
or the noise made by the player. All scripting will be donein C+ Animations will 
be taken care of by the editor and some other cool options. 


Chapter 5, Adding Collectables, spices things up with some collectables! We will learn 
about some of the triggering and overlapping events, more about adding new classes, 
and adding some physics to the collectable items. 
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Chapter 6, The M agic of Particles, shows how to add in some particles to complete 
the coolness! We use cascade to build particles for the enemies, weapons, and 
collectables, and learn to tie these to the game logic. 


Chapter 7, Enhancing the Visual Quality, shows how to make the game better looking 
by focusing on the most important rendering features of the engine, to make things 
pretty. You will learn to bake light maps. 


Chapter 8, Cinematics and In-Game Cutscenes, covers the tools required to build an 
in-game cut-scene for a better gameplay experience and story direction. 


Chapter 9, Implementing the Game U I, shows how to add a solid UI to the game is what 
will get the players going "Hell Yeah!" Make use of Unreal Motion Graphics (U MG) to 
tinker with different screen sizes and build a superb looking UI for your game. 


Chapter 10, Save the Game Progress, shows how to write a "save and load" function in 
order to save the progress in order to be able to resume the game later. 


Chapter 11, Controlling Gameplay via D ata T ables, shows how to use data tables to drive 
the gameplay values for the enemies and so on (it is widely used in tons of game 
genres, such as Tower Defense, RPG, Roguelike, RTS and so on) 


Chapter 12, Ear Candy, shows how to add audio experience to the gameplay. You will 
learn how to cue the audio and use the clips in the scenes. 


Chapter 13, Probling the Game Peformance masters the various editor debugging and 
probling tools to depbne the performance issues. 


Chapter 14, Packaging the Game, you will learn how to make an executable of the game 
for release. We also add a splash screen to show you're the boss, cook the game, and 
then use the project launcher to release It. 


What you need for this book 


In order to be able to follow along with this book, you need to havea good foundation 
of C, as the book mostly focuses on building an Unreal game using C+- You also 
need to have Unreal Engine installed and Visual Studio, and both be available for free. 


If you are on a Mac or Linux, you'll depnitely need another IDE to use with Unreal 
Engine, as Visual Studio is not supported on those platforms, but you'll still be able 
to go with the book smoothly. 


Good game design and level design skills are great and will help, but they are 
not essential ! 
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Who this book is for 


This book is for game developers who have basic knowledge of Unreal Engine and 
also have basic C++ scripting knowledge. This is ideal for those who want to take 
the leap from a casual game developer to a full-yedged professional game developer 
with Unreal Engine 4. 


Conventions 


In this book, you will pnd a number of text styles that distinguish between different 
kinds of information. H ere are some examples of these styles and an explanation of 
their meaning. 


Code words in text, database table names, folder names, blenames, ple extensions, 
pathnames, dummy URLs, user input, and Twitter handles are shown as follows: 
"The game we are going to create during the course of this book is called Be! |z." 


A block of code is set as follows: 


UCLASS(config = Game) 
class AGladiator : public ACharacter 


{ 
GENERATED_BODY( ) 


N ew terms and important words are shown in bold. Words that you see on the 
screen, for example, in menus or dialog boxes, appear in the text like this: "Otherwise 
inside the launcher, just hit the Launch button of the editor version you want." 


| Warnings or important notes appear in a box like this. | 


| Q Tips and tricks appear like this. | 
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Reader feedback 


Feedback from our readers is always welcome. Let us know what you think about 
this book—what you liked or disliked. Reader feedback is important for us as it 
helps us develop titles that you will really get the most out of. 


To send us general feedback, simply e-mail feedback @packt pub. com, and mention 
the book's title in the subject of your message. 


If there is a topic that you have expertise in and you are interested in either writing 
or contributing to a book, see our author guide atwww. packt pub. com authors. 


Customer support 


Now that you are the proud owner of a Packt book, we have a number of things 
to help you to get the most from your purchase. 


Downloading the example code 


You can download the example code bles for this book from your account at 
http://www. packt pub. com. If you purchased this book elsewhere, you can visit 
http://www. packtpub. com support and register to have the ples emailed 
directly to you. 


You can download the code ples by following these steps: 


Log in or register to our website using your e-mail address and password. 
Hover the mouse pointer on the SUPPORT tab at the top. 

Click on Code Downloads & Errata. 

Enter the name of the book in the Search box. 

Select the book for which you're looking to download the code ples. 
Choose from the drop-down menu where you purchased this book from. 


NOM BWN 


Click on Code Download. 


You can also download the code ples by clicking on the Code Files button on the 
book's webpage at the Packt Publishing website. This page can be accessed by 
entering the book's name in the Search box. Please note that you need to be logged 
In to your Packt account. 
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Once the ble is downloaded, please make sure that you unzip or extract the folder 
using the latest version of: 


A WinRAR/ 7-Zip for Windows 
Å Zipeg/ iZip/ UnRarX for Mac 
Å 7-Zip/ PeaZip for Linux 


The code bundle for the book is also hosted on GitHub athttps:// github. com/ 
Packt Publishing/ Mastering-Unreal-Engine-4X.Wealso have other code 
bundles from our rich catalog of books and videos available athttps:// github. 
com/ Packt Publishing/ . Check them out! 


Downloading the color images of this book 


We also provide you with a PDF þle that has color images of the screenshots/ 
diagrams used in this book. The color images will help you better understand the 
changes in the output. You can download this blefromht tp: // www. packt pub. com/ 
sites/default/files/downloads/MasteringUnreal Engi ne4X Color! mages. pdf. 


Errata 


Although we have taken every care to ensure the accuracy of our content, mistakes 
do happen. If you pnd a mistake in one of our booksn maybe a mistake in the text or 
the code—we would be grateful if you could report this to us. By doing so, you can 
save other readers from frustration and help us improve subsequent versions of this 
book. If you pnd any errata, please report them by visiting http://www. packt pub. 
com/ submit - errata, Selecting your book, clicking on the Errata Submission Form 
link, and entering the details of your errata. Once your errata are veriped, your 
submission will be accepted and the errata will be uploaded to our website or 

added to any list of existing errata under the Errata section of that title. 


To view the previously submitted errata, go toht tps: // www. packt pub. com/ books/ 
content/support and enter the name of the book in the search pead. The required 
information will appear under the Errata section. 
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Piracy 

Piracy of copyrighted material on the Internet is an ongoing problem across all 
media. At Packt, we take the protection of our copyright and licenses very seriously. 
If you come across any illegal copies of our works in any form on the Internet, please 
provide us with the location address or website name immediately so that we can 
pursue a remedy. 


Please contact us atcopyright @packt pub. com with a link to the suspected 
pirated material. 


We appreciate your help in protecting our authors and our ability to bring you 
valuable content. 


Questions 


If you havea problem with any aspect of this book, you can contact us at 
questions @packt pub. com, and we will do our best to address the problem. 
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Preparing for a Big Project 


When you are about to create a C++ game using Unreal Engine, it means that you are 
going to create a big project. The two specipc reasons for such a choice are: you area 
core programmer and not familiar with the blueprints concept, or you want the game 
to run faster. Either way, you are about to get the right start here. 


It's been said several times that C++-based games are quite a bit faster (10 times 
faster) than games made with blueprints. Although that was hearsay on the Unreal 
forums, the fact is that it is partly true. All games made with Unreal are equal 

in performance to those relying on the same technology and engine code base. 
However, when things get complex, it gets a little slower, and that speed difference 
IS not as noticeable; it is something measured in milliseconds. 


Starting a C++ project with Unreal is quite different, as it is not something that can 
be done inside the editor anymore. You'll need all the help of the IDE and, based on 
your platform, the setup will be different. My setup currently while writing this book 
is Windows 10, Unreal 4.10 and Visual Studio 2015. A part from Google Documents, 
that's all that | need to create my data tables, and that's all that is needed! 


By the end of this chapter, you will be able to: 


Å Start anew Unreal Engine C+ project from scratch 

Set the project and editor settings to match your needs 

Map any input device to match your game design 

Import and export assets in and out of the Unreal Editor 
Migrate assets between the different Unreal projects 

Retarget animations between the different skeletons 

Add the required modules and header files to the project code 


> Do > To Do To 
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Overview of the game 


The game we are going to create during the course of this book is called Be! | z; it's 
depnitely a word without a meaning. Its name came from the H ell Bells, as we are 
planning to put some unique bells around the maps! 


The game Is built with C+- While it is a C+ project, about 5% consists of necessary 
blueprints and other different graphs! 


Bellz is athird-person RPG, where you havea mission loaded from Excel tables, 
weapons to use with different attributes, and evil enemies to escape from or to hunt. 
It looks simple, and the fact Is, itis, but it holds all the needed elements to create a 
visually appealing AAA game. So that we stay on the same page, this game will take 
you step by step through the processes of: 

Starting a C+ project based on a blank template. 

Creating a player controller. 

Building enemies, behavior trees, and blackboards. 

Creating animation graphs and retargeting different animations. 

Loading game-required data from the design data tables. 

Adding camera animations and cut scenes to the game. 

Adding audio effects and visual effects to the game. 

Creating and building appealing maps. 


O ANAM BPWN FP 


Optimizing the game as much as possible. 
10. Debugging the game performance. 
11. Packaging the game to players. 


The following is a screenshot of the pnal game: 
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Creating a C++ project 


With the goals set, let's get started by launching the Unreal launcher. If you already 
have an Unreal Editor instance running, that is not a problem; just choose to make 
anew project from within the File menu and that will launch the proper screen 

of the launcher. Otherwise inside the launcher, just hit the Launch button of the 
editor version you want. After a few seconds of loading, the editor project selection 
window will appear. Do the following: 


1. 


NOW FB WN 





Switch to the N ew Project tab. 

Under N ew Project, switch to the C ++ subtab. 
Choose a Basic Code project type. 

Set the target to D esktop/C onsole as that's our target! 
Set the quality to Maximum Quality. 

Remove the starter content, it will not be useful at all. 


Give your project a name, but make sure to remember that name, as a lot 
of the code will be using it. Mineis called Be! | z. I would say go ahead and 
name your project with the same name so you can easily follow along with 
the tutorial without any confusion or naming conyicts. 


Finally hit Create Project! 


Projects New Project 


Chonst a template toss a sharing poent for your new propect Any of these Gestures 


Blueprint “gece 


Basic Code 


An empty project with some basie game framework code classes treated, 


bese labet inthe Target Hardware sector ol Propect Sellmgs You cin also add the Starter Content to your proyect abet 


ainni Chea lity 


Hente Projecd 
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Preparing for a Big Project 


If that was your prst time creating a code project (which | guess is the case for the 
book's target audience), the project will take quite a time, it is not going to appear 
within a second like the other blueprint-based projects. 


A C++based project needs to copy some header ples, build a Visual Studio 
solution/ project (or Xcode if you are running on Mac), add the necessary code 
to the project, build ples, inputs, the engine, and so on, and then pnally run the 
Visual Studio command-line tool to compile and launch the project editor. 


Now that you havea basic project, shall we go ahead and learn more about the 
C++ game project structure? 


Yes! 
But why? 


Well, an Unreal project could increase to a crazy size at some point, especially if 

you are going to source-control your project using Git or SVN. You have to be wary 
about the space, as some free hosting services put a limit on the ple type and ple size 
you are using within your repository. 


By opening thegame project folder you will have these ples and folders; some new 
bles and folders might appear in the future as long as we keep adding stuff to the 
project. This is what | had by the end of the project: 


Name Type 


m Binaries File folder 

| | Build File folder 

| | Config File folder 

p' Content File folder 

all Intermediate File folder 

p. Saved File folder 

La Source File folder 

lad] Bellz PNG File 

Ta Bellz SOL Server Compact Edition Database File 
mi Bellz Microsoft Visual Studio Solution 


que Bellz Unreal Engine Project File 
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While the folder is full of subfolders and ples, it makes much more sense to break 
it all down. If you understand how the project directory works, it will be easy to 
understand how the game director works, and how you can optimize the size of 
the project. 


A 


A 


Bi nari es: Thisfolder holds. dl | files and executables that will be 
autogenerated during the compilation time. 


Bui |d: A folder for all the necessary files to build the editor or the 
game itself. 


Conf i g: A whole folder for the configuration files, basically a bunch of text 
files that hold alot of the settings you set for the project and the game from 
within the project setting and the editor settings. You can do changes here, 

but it is not that easy to locate exactly what you want. However, it's a good 
place to search for the causes of problems. 


Content: TheContent folder hosts all the assets, blueprints, maps, 
Marketplace assets and any other item you use to build your game. 
Any folder you create inside your editor to hold some assets will end 
up insidetheCont ent folder. Code files will not be included inside the 
content, in case your game Is based on C++ not blueprints. 


| nter medi ate: The majority of the files underneath this folder are temporary 
files, all of them being generated while building the game or the engine, 
which means deleting this folder's content will not affect you, as all the 
content will be regenerated as soon as you build. 


Saved: TheSaved folder contains lots of different saved files, some are 
backups that are saved every once in a while, some are autosaved copies 

of the assets, and other files are the save data of the game itself (Saved using 
the save API). 


Source: This folder contains all the game code. Any C++classes you are 
going to add in the future for the project will end up in this folder. 


PNGI mage: Theicon file for the project, which has the same name as the 
project; it is not necessary for it to represent the final build, but will be 
mainly used to visualize the project at the Unreal Launcher library section. 
Keep in mind that this image must be a square of 192 by 192 pixels. You can 
change it either by directly replacing it, or through the project settings. 


SQLFile:Thisisan. sdf format file named with the project name; you don't 
have to worry that much about it, as Visual Studio will be generating a new 
one every time you open the solution. 
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A Visual Studio solution: TheVisual Studio solution for the game code 
has the same name as the project. You can open it directly, or you can launch 
it from within the Unreal Editor itself through the File menu. Keep in mind 
that the project options section of the File menu is very dynamic. If you have 
a C++based project (such as the one we are creating) the menu will always 
give you two main options, the first to refresh the Visual Studio project and 
the second to open the Visual Studio project. 


Project 
W New Project... 


Open Project... 

W New C++ Class... 

MM) Package Project > 
Refresh Visual Studio Project 
Open Visual Studio 


Cook Content for Windows 





But if you made a blueprint-based project, and at some point you wanted to 
convert it to a code file, you will find that the project options of the File menu 
display only one option for the Visual Studio, which is G enerate Visual 
Studio Project. 


Project 
W New Project... 
W5 Open Project... 


© New C++ Class... 


ED Package Project b 


Generate Visual Studio Project 


Cook Content for Windows 





A Unreal Engine Proj ect: An Unreal Engine project file that has the same 
name as the project and has the extension *. uproj ect . You can easily open 
the project using it, either by double-clicking on it or by browsing for it from 
the Unreal Launcher. 


The project settings 


Now we havea project set and running. However, that's not enough for us to start 
adding code, assets, and logic for the game. A game project has tons and tons of 
settings and options, which will have been set to default values when you create a 
new project, and every time you make anew game or project, you have to set those 
settings to specipc options that pt your needs and your goals. 
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Accessing the project settings is very easy as you only have to click on the Project 
Settings button at the end of the Edit menu button. 


First things prst, | like to always set the overall information about my project at an 
early stage, so! don't have to worry about it later. From the D escription section of 
the project settings, you can set the company name, and its homepage; also you can 
assign the logo for the project to be displayed on the launcher and description of the 
project and its name. 


The most important part for this C++-based project is to set the copyright notice. By 
depning a piece of text here, it will be automatically added to all your newly created 
C++hples. So you have a copyright added to your codeé Justin case! 


Project - Description 
Descriptions and other intormation about your project 


(ky These settings are saved in DefaultGame.ini, which is currently writable. 


4 Publisher 
Company Distinguished Name 
_ 


4 About 


Project Thumbnail 


Description Bellz, a 3rd person action gamed made in C++ and Unreal4.10 


Project ID {BA267E52-4429-841F-35E3-E392541F91AA} || 


Project Version 


4 Legal 


Licensing Terms _ 
Privacy Policy i) 
4 Displayed 


Project Displayed Title 
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Another important option to set is the map to be used as the default map for the 
game and for the editor. | agree that we don't have maps set yet but once you have 
a map, you need to set it inside the M aps & M odes section; so you make sure that 
every time you run the editor, you don't haveto reload the map you want. 


s & Modes 


and other map related settings. 


Project - Map 
Default maps, game mode: 


pe These settings are saved in DefaultEngine. ini, which is currently writable. 


4 Default Maps 


Game Default Map /Game/Maps/gameLevel Ez 
Editor Startup Map /Game/Maps/gameLevel | + | 





Finally, | would like to set the targeted platforms. | already know that my game will 

be running on PCs and consoles, so there is no need to label my game as an Android 
or iOS game for example. Therefore, you can just uncheck the untargeted platforms 

from the Supported Platforms section. 


Project - Supported Platforms 


@, All Platforms 


Android 
HTMLS5 

é ios 
Linux 
Mac 
PlayStation 4 
Windows 


E XboxOne 


a 
w 
= 
iE 





The editor settings 


To access the editor settings, from the Edit menu, just choose Editor Preferences. 
If you are using a Mac, you might pnd it in a different place, usually it is called 
Preferences or Editor Preferences and it is listed under the Unreal Editor menu. 
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There is not much that needs to be changed within the editor settings, as it is mostly 
about personal, preferred settings while working with the editor. | don't mind 
sharing the few changes | made for the editor of Be! | z , but feel free to ignore them 
and apply your preferred settings, or don't apply any editor settings at all if you 
prefer to keep it that way. 


Under the Loading & Saving section of the General settings, | managed to 
disable the autosave option for any asset type; that way | make sure that the editor 
saves only on my demand, and I'll not get too many unnecessary bles, keeping my 
project size as small as possible. Also, disabling the source control (if you are not 
using it, or you are using another source control system) is a good way to go with 
a smaller project! 


General - Loading & Saving 


4 Startup 
Load the Most Recently Loaded Project at Startup i 
Load Level at Startup 
Force Compilation at Startup A 


Restore Open Asset Tabs on Restart 


4 Auto Reimport 


Monitor Content Directories 


4 


4 Blueprints 

Dirty Migrated Blueprints 
4 Auto Save 

Enable AutoSave 

Save Maps 


Save Content 


Frequency in Minutes 


Fa 


Waring in seconds 

4 Source Control 
Automatically Checkout on Asset Modification 
Prompt for Checkout on Asset Modification 


Add New Files when Modified 


Use Global Settings 


Tool for diff'ing text pémerge.exe ses 
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From the Play section of the Level Editor settings, make sure you enable Game Gets 
M ouse Control; this way | make sure that the game has the advantage of using the 
mouse over the editor. 


Level Editor - Play 


Set up window sizes and other options for the Play In Editor (PIE) feature. 


a Play in Editor 


Game Gets Mouse Control 


Show Mouse Control Label 


Mouse Control Label Position Top Left ¥ 


Viewport Gets HMDControl (a 





And that's it. There are lots of changes | used to make to the editor, but there were 
mostly related to changing the colors to pt my experience and keeping the overall 
visual look of the objects the same between all the applications | was using. For 
example, changing the color of selected objects to match the selected objects in Maya 
viewport, so! keep things consistent. But those two options are the important ones 
that have an impact on my experience while working. 


Mapping the inputs 

While the input setting relies on the project setting, | always like to discuss it as 
an individual topic. If you have come from an engine structuring background, 
you probably know that the inputs are an independent topic just like rendering, 
networking, and so on. 


Any game built within Unreal Engine (or any game in general) must have the input 
class, which depnes the whole input for the game. Fortunately, Unreal Engine 

has made this step easier, and has given you the chance not to worry about input 
handling. It does this for you at a lower level of the engine core, and gives you a nice 
and easy-to-use interface, where you can map some predebned input keys, buttons, 
and axes, and name them. You can then refer to these buttons by code using their 
respective names. 
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Unreal Engine supports a lot of input devices, which has made the input mapping 
list huge, and it is better to learn more about the supported devices in order to make 
this huge list easy to manipulate. The inputs that are supported are: 


A 


D> D> > > > 


A 


Gamepad: This contains the mapping for all the buttons and axes used by 
any gamepad type 


K eyboard: This contains the mapping for all the keyboard keys 
M ouse: This contains the mapping for all the mouse buttons and axes 


M otion controllers: They contains the mapping for any motion device, such 
as Razer for example 


Gesture: This contains the mapping for some gestures integration, which 
could be used with any touch device (mobile, touchpad, and so on) 


Steam: This contains the mapping for the special buttons of the Steam 
controller; all other Steam controller buttons are accessible through the 
gamepad inputs 


Xbox One: This contains the mapping for the special buttons of the Xbox 
One controller; all other Xbox One controller buttons are accessible through 
gamepad inputs 


Android: This contains the mapping for the special buttons of Android 
devices (Back, Volume, Menu, and so on) 


And that's how the list of inputs looks by default while every section is folded; 
unfolding those sections will give you an endless list of keys and buttons that 
you can map for your game and for different platforms and devices. 


> Android 
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In order to use these inputs for your game, you have to select some keys and 
give them names; this is called the process of Binding Keys. But before diving 
into this process, you will have to understand the different types of binding 
within Unreal Engine. 


Unreal Engine supports two main binding types; they are divided by the sensitivity 
of the input key/ button. This means that the input button/ key could brea couple of 
events when it is pressed and/ or released, or it will keep pring events as long as itis 
pressed. The two main types of bindings are: 


Å Action mapping: Action mapping should represent a button or key press, 
and then within the code you can call some logic based on pressing that key 


Å Axis mapping: Axis mapping should represent a value change of the 
pressure on the button, which usually works with the trigger buttons 
of acontroller or the thumb sticks of the controller as well 


Here are few more points to remember before we start the mapping process: 


A Thegamewill be using the keyboard and mouse as PC inputs and will be 
using the controller/ gamepad as the console input (you can still use the 
controller with PCs, though). 


Å I highly recommend that you use the same names | used to map my keys; if 
you change any, you have to be aware that you have to change them within 
the code as well. 


Å To add anew action mapping or axis mapping, you just need to hit 
the = sign next to the action and/ or axis title. But if you want to add more 
buttons to the same action or axis, then you need to hit the + sign next to the 
action map itself. 


P Action Mappings = Ü 





ee a 


Now you are ready to go. By opening the project settings from within the Edit menu, 
and then navigating to the Input options under the Engine section, you have access 
to the inputs mapping. You can now start mapping your key inputs. 

Å Action mappings: This contains the following options: 


° Jump: Will be using either Spacebar or the controller lower face 
button to perform the jump on press 
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° Attack: Will be using the LMB or the controller right trigger to 
perform attack. 


° _ChangeWeapon: Will be shuffling between weapons on pressing 
the Tab button or the Gamepad Right Shoulder (the one above 
the trigger). 


The end result of this action key mapping should eventually look something like this: 


4 Bindings 
Action and Axis Mappings provide a mechanism to conveniently map keys and axes to inp 
4 Action Mappings + gj 
F) Jump + x 
„= Gamepad Face Button Bottom v iuis keus EUs feo E. 


PI Attack + x 
Pi ChangeWeapon + x 
Saah -Eus kaus Eus Kenci E: 





Å Axis mappings: This contains the following menu: 


° MoveForward: Will be using the keyboard's W or S or Up/ Down 
arrow, or the controller Y axis of the left thumb stick, to move the 
player forward and backward. The value of 1 means forward and 
the value of 0-1 means backward. 


° MoveRight: Will be using the keyboard's A/ D or the controller X 
axis of the left thumb stick to move the player right and left. The 
value of 1 means right and the value of 0-1 means left. 


° TurnRate: Will be using the keyboard arrows or the X axis of the 
right thumb stick of the controller to rotate the camera sideways. 


° Turn: Will rotate the camera sideways using the mouse. 


° LookU pRate: Will be using the Y axis of the right thumb stick of the 
controller to rotate the camera up and down. 


° LookUp: Will lookup using the mouse Y axis. 


[13] 


Preparing for a Big Project 


The end result of this axis key mapping should eventually be something like this: 


4 Axis Mappings + w 


PE MoveForward + x 


Scale MSD x 

Scale ESD x 

Scale SNSD x 
PE MoveRight + x 

Scale SNSD x 
Pi TurnRate + x 

Scale SNSD x 

scale (SD x 


Pe Tun + x 


TE 


=i LookUpRate + x 


„m Gamepad Right Thumbstick Y-Ax ~ EET 1.0 o EE 


FE LookUp + x 





Now you have successfully mapped the game inputs. Keep in mind that you might 
need to map more keys in the future, but those are the keys |I needed for Be! | z. If 
you need more you can keep adding and mapping keys based on your game design. 
Personally | found those inputs are enough for our current example. 


If you still remember the project directory we mentioned earlier in this chapter, 
there was aconf ig folder for the project. If you access thisconf ig folder, and 

you open the Def aul tl nput.ini pleusing any text editor, you will pnd the input 
mapping that you've already done at the end of theDef aul t! nput.ini ble This 
means those inputs are modipable at any time because the shipped game will have 
a similar ple eventually! 


Migrating assets 


In some cases, you might have an asset within an Unreal project that you want to use 
within another project. And because Unreal content is converted into. uasset ples, 
it is not that easy to just copy assets from the Cont ent folder of a project into another 
Content folder of another project. 
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For this game, we are about to create the basic animations of the default Unreal 
Engine mannequin character, to be used by my character. Therefore, by opening 

any of the Unreal projects and by selecting the required animation ples, you can just 
right-click on them and choose M igrate and then choose the new project you want to 
copy assets to. 


F 


® Show in Folder View Select Actors Using This Asset 
a) 


Show In Explorer 
Export... 
Copy Reference Bulk Export... 
Reference Viewer. 
Size Map... 


Bulk Edit via Property Matrix.. 





m Connect To Source Control... 


That way, all the assets with the required dependencies will be copied to the new 
project. However, achieving it by just doing a window-level copying will not 
guarantee you move all the required bles. In my case, when | was copy animations 
the editor found that | needed to copy the character mesh, skeleton, and the materials 
as well. Those have been selected automatically for me and set alongside the targeted 
animation ples. 


Al Asset Report 


The following assets will be migrated to another content folder. 
gg | Nirarerson_attack J 
By ThirdPerson_Attack8 
 ThirdPerson_Dead 
R ThirdPerson_GetHit 
 ThirdPerson_GetHit_Left 
 ThirdPerson_GetHit_Right 
 ThirdPerson_idle 
B ThirdPerson_idleRun_2D 
B ThirdPerson Jump 
 ThirdPerson_Pickingup 
B ThirdPersonidle 
 ThirdPersonJump_End 
 ThirdPersonJump_Loop 
B ThirdPersonJump_Start 
B ThirdPersonRun 
 ThirdPersonWalk 
4 fi Character 
4 fi Materials 
) M_UE4Man_Body 
A M_UE4Man_ChestLogo 
4 i MaterialLayers 
BR ML_GlossyBlack_Latex_UE4 
@ ML_Plastic_Shiny_Beige 
@ ML_Plastic_Shiny_Beige LOGO 
A ML_SoftMetal_UE4 
 T_ML_Aluminum01 
 T_ML_Aluminum01_N 
@ T_ML_Rubber_Blue_01_D 
@ T_ML_Rubber_Blue_01_N 
4 fe Mesh 
A SK_Mannequin 
R VE4_Mannequin_Skeleton 
4 fi Textures 
fh VE4_LOGO_CARD 
R VE4_Mannequin_normals 





 VE4_Mannequin_MAT_MASKA 
R VE4Man_Logo_N 





ok J cancel 
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Finally, atypical OS window will pop up to ask you to choose the destination 
folder/ project you want to migrate the assets and all its dependencies to. 


Using MarketPlace assets 


Now as asingle-person project (me or you, we are both working as individuals now), 
you can't make the entire game all by yourself. In other words, time, and the goal of 
this book, do not allow us to do that. Thus, that's the reason behind relying on some 
free assets, or you might like to get some of it outsourced. It is all up to you. 


For Bel | z,! used a mix of assets provided by Epic games; they are free to use and 
you can get them from the launcher. The assets arelabeled with! nfinity Blade 

(yeah, those assets are a free giveaway from Epic and the developer of the game), 

and they are really top-quality assets. 


While those assets look perfect, not that many animations come with the packages 
so | used some of the free animations provided by Epic and asked a friend to make 
some other animations for me to use. 


A good exercise here is to follow the migrate process we discussed earlier in this 
chapter in order to migrate some of the custom animations I've made in the book's 
project, and move them into your project. 


In order to get the packages installed, you have to download them prst from the 
M arketplace section of your launcher, then you will pnd a button next to those 
packages that displays Add To Project. |'ve added warriors, enemies, weapons, 
and the grass environment to my project. Feel free to add them as well (I highly 
recommend them) or get your own assets. 


There are three types of environment presented for free; you are free to pick the one 
you want. | just liked the grassy one. After making your decision about which to use 
of the free packages, all that you have to do is to hit the Add To Project button. Keep 
in mind, some of the Mar ket pl ace packages don't have the Add To Project button, 
and they have only a Create Project button; with those packages you'll need to create 
a whole new project in order to be able to use them or migrate some of their assets to 
your current project. 


Infinity Blade: Warriors 





[16] 


Chapter 1 


This will take you to a whole new section of the launcher, and you probably have 
never been there before. It displays all the valuable projects that could match this 
package. It is all about the engine version and the package version which usually 

have to match, and Epic might change this condition in the near future. Anyway, 

| made my choice as Bellz. 


Select Project to Add the Asset to 


Show all projects 


PureGame TestGame 





Add to Project Don't Add 


Now it will take some time to load and add the directories and the assets to your 
project. Go ahead and redo the process for the other packages you want to add 
to the project (the warriors, enemies, and weapons). 


Infinity Blade: Warriors 





Keep in mind that, if you are using Windows, you don't have to relaunch the project. 
In a Windows version of the editor, once you add a package to the project through 
the launcher, you can locate them right away from within the editor. But if you are 
running Unreal on a Mac, you have to relaunch the editor in order to þnd the assets 
inside the project. 
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Feel free to take your time to check the characters, enemies, weapons, and the 
environments and all the animations provided by them. Also spend sometime 
migrating any animations you want from the project sample that came with the 
book, and decide which assets you are going to use with your instance of Be! |z, 
and delete any other unneeded assets, such as all other characters, enemies, and 
weapons. Those bles are large, and will heavily increase your project size, so, It's 
a good idea to keep the project as clean as possible as we go. 


Retargeting animations 


When I was choosing my characters, | picked the bear as my main game enemy. The 
choice came as a result of several factors. First, | liked the two attack animations that 
the bear has, it is very strong and has great key poses. Second and most importantly, 
the bear has no idle, walk, or run animations, and it's a good opportunity to check 
some of the Unreal tricks of duplicating animations from a skeleton to another 
different skeleton. This is called animation retargeting. 


By default, when you import an animation for the prst time, you will be asked to 
either use an already made skeleton asset from within the project, or to import the 
asset skeleton and build a skeleton asset out of it. For several animations of the same 
character, you will keep reusing the skeleton asset, but once you Import a different 
character it'll force Unreal to create its own skeleton structure asset. 


Now, as you might have noticed, each enemy of the Inpnity Blade assets has its 
own skeleton assets, and our main focus here is to somehow get an idle animation 
alongside the running and/ or walking animation for the bear. As you noticed, the 
bear has only two animations! 
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Now if you check what the closest animal is in body structure and skeleton hierarchy 
to the bear (and included in the assets), you will pnd the wolf asset. This asset has 

all that we need and more, it is very similar to the bear, and it has walking and idle 
animations, alongside other attached animations. The goal now is to retarget and 
close the walk and idle animations of the wolf and use them with the bear. After 

we pnish that, we will retarget the walk animation once more, and change its speed 
factor in order to make it look like a running animation (a run is just a fast walk, 
huh?!), and that will save us the time of creating animations or assets from scratch. 

It will even save us more time if we want to send the bear asset back to M aya or 
3dsM ax to add some more animations for it. 


(E Perspective) (ta) (stow ) (L00 amo )(- 11.0) (0.0) ($ © AOE va] ) sa 


Previewing Reference Pose 


LOD: 0 

Current Screen Size: 2.80 
Triangles: 1470 

Vartices: 1291 

UY Channels: 1 

À YA 2i Zii thr, 





The retargeting process is very simple; you can consider it as the following steps: 


1. Create an intermediate skeleton structure (called Set up Rig). 


2. Deþne the Source character skeleton (the wolf), based on the intermediate 
skeleton. 


3. Deþne the Target character skeleton (the bear), based on the intermediate 
Skeleton. 


4. Retarget the required animation from the source into the target. 
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While we havea plan, let's get started in retargeting the animation. By opening the 
wolf skeleton asset, you will be inside the Persona editor. At the top there is a button 
called Retarget M anager. Hit it! 


Retarget Manager 





That will open the retargeting window for you; it is very simple, you need to create 
the skeleton by hitting Add N ew Retarget Source and then start assigning the wolf 
bones to the correct slots of the intermediate skeleton. You don't have to pll them all, 
you just need the animated bones to be assigned. Keep in mind, at any time, if you 
need to assign more bones that are not shown on the intermediate skeleton, you can 
press the Show Advanced button in order to display more bone options to assign. 
Nevertheless, from my experience with this wolf skeleton asset, those basic bones 
are enough. 


After assigning the bones you should end up with something like the following: 


Set up Rig 


You can set up Rig for this skeleton, then when you retarget animation to different skeleton with the same Rig, it will use the information to convert data. 


Select Rig Humanoid X Show Advanced 


Node (Rig) Bone (Skeleton) 
Root 

Pelvis 
spine_01 
spine_02 
spine_03 
clavicle_| 
UpperArm_L 
lowerarm_] 
Hand_L 
clavicle_r 
UpperArm_R 
lowerarm_r 
Hand_R 
neck_01 


head 


Thigh_L 


calf_| 
Foot_L 
Thigh_R 
calf_r 


Foot R 
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N ow, let's do the same thing with the bare bones. Open its Persona, and start 
assigning the bones to an intermediate skeleton. There are two things you might 
notice here: the wolf has one more bone within the legs, and it bts its real bone 
structure. In addition, the wolf has a tail, while the bear skeleton has no tail. That 
will not affect us too much, but make sure not to assign something wrongly. Feel 
free to ignore those extra bones from the wolf. 


After assigning the bones, you should end up with something like the following: 


Set up Rig 


You can set up Rig for this skeleton, then when you retarget animation to different skeleton with the same Rig, it will use the information to convert 
data. 


Select Rig Humanoid Show Advanced 


Node (Rig) Bone (Skeleton) 
Root 

Pelvis 

spine_01 

spine_02 

spine_03 

clavicle_| 

UpperArm_L 

lowerarm_] 


Hand_L 


clavicle_r shoulder_rt v m 
Upperarm LS 
loweram SS E 


Hand_R 
neck_01 
head 
Thigh_L 
calf] 
Foot_L 
Thigh_R 
calf_r 


Foot.R 





Now itis time to do the pnal step, which is retargeting (cloning) the animations 
themselves from the source to the target. By accessing the animation assets of the 
wolf (under theani mati ons folder within thewo!l f folder), you can select any of the 
animations (let's start with the idle animation); right-click and, from Retarget Anim 
Assets, choose D uplicate Anim Assets and Retarget. That's enough to take you to 
the bnal step of retargeting. 


® Find Skeleton 


mported As 
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The Select Skeleton window will show up. This window will already have the 
retargeting source skeleton selected and display its character. It requires you to 
select the target (which is the bear), by selecting the bear skeleton (the one we have 
already assigned to the intermediate skeleton) and hitting Select; that will copy the 
animation right away for you, and set it to the animation for the bear. 


wiect Skeleton "X 


Select Skeleton 


Make sure you have the sindar retarget base pose. I they don't look alike here, you can edit your base pose in the Retarget Mansgert window to look alke 


[Target] 





Now it's time to rename the animation to something which makes more sense. The 
new animation will still have the name of the wolf, but it has a thumbnail of a bear 
character, and it is only playable over the bear skeleton; thus you probably need to 
rename it bear. 


Do retarget all the animations you want, but don't forget to rename them and move 
them to thebear folder, just to keep things organized. 


After you are done duplicating/ retargeting all the animations you want, | would 
recommend you duplicate the walking animation again for the bear, but this time 
name it run. After you have done the duplication, double-click on the animation 
asset. That will run Persona again, but this time it will be activating the Animation 
tab, not the Skeleton tab like before. 


From the left side, there is a panel called Anim Asset D etails. M ake sure to set the 
Rate Scale under the Animation tab to 2.0, which will change the speed of this 
animation asset. By having it run fast, it really looks like a real run. Now we have 
managed to get lots of animations working and running for the bear, without the 
need to do asingle animation frame! 


d Animation 


Retarget Source 
Rate Scale 


Skeleton 
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Summary 


You went through the process of starting a big game from the ground. You learned 
how to select a base C++ code project, which is not based on any other premade 
code, and totally understood the project structure, which folders are important, 
and which folders you can simply ignore. 


You also learned about how and where to þnd the project settings and the editor 
preferences, and you got an idea about what type of settings you can pnd there, 
and how to adjust some of them to bt your needs. 


All games have inputs, and now you know where you need to map those inputs for 
your game. You are not only aware of how to set up game inputs, but also you Know 
all the input types and the limits of supported input devices with Unreal Engine. 


All games have assets, and now you have learned how to be tricky while working: 
how to integrate packages from the Marketplace, or move assets between different 
projects without any trouble by just migrating them, not only copying them. 


Animations are essential, but sometimes we have to retarget animations in order to 
bx some problems we have or to fasten the process. You now know all the needed 
steps and skills to be able to retarget any animation into any skeleton. 


Now with all of that fresh in your mind, | highly recommend you dive into the next 
chapter right away. Let's start writing code and building our player controller from 
the ground up. 


[ 23 ] 





setting Up Your Warrior 


Once we have the project set up and running, it is time to start making the game 
itself and put something together that we can call a playable game. 


The most important part of any game is the player controller. Regardless of the game 
genre and type, the player has to control the game somehow. It may bein the form 
of controlling the environment or controlling a character through the environment, 
or even something else. 


Because the game we are building here is a third-person type of game, our players 
will have to control a character (I'm calling himThe Gl adi ator ). This character will 
be based on the Unreal character class, as it gives us many benepts and saves us lots 
of time because the character class is basically aPawn class and pawns are actors that 
are controlled either by the player or Al. The character class we are building is going 
to be fully controlled by mouse and keyboard or the gamepad controller. 


Keep in mind that we are building our own character class from scratch and not 
basing our character on the Unreal one, so this process will take a long time. Almost 
90% of Unreal game characters are based on the unreal character class, and that's the 
reason behind having some base classes shipped with the engine. 


The character controller we are going to create will be able to walk, jump, control the 
camera, play animations, switch weapons, affect enemies, get affected by enemies, 
show some statistics in the UI, read weapon data from the data tables and, most 
importantly, die when it is the time to die! 
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By the end of this chapter, you will be able to: 


Å Build the character class in C++ 

Write movement logic 

Map key inputs into the player controller logic 

Build the character animation blueprint 

Add an animated mesh, and display animations from the character class 
Add sockets to the skeletons 

Build animation blend spaces and use them 


> Do Jo To Do Jo To 


Assign and use any character as the default game character 


The code project 


We have already created the project and launched Visual Studio. Once you open 
your project's Visual Studio you'll pnd it is not empty. There are some classes and 
bles that have been generated for you automatically to start you off and give you a 
minimal base for a game that you can use and run. 


The Visual Studio solution will contain two major projects: 


Å UE4:Thisis listed under theEngi ne folder of the solution, and it is a project 
that contains the important header files, tools, plugins, and so on, of the 
Unreal Engine, so you don't have to worry about it most of the time. 


Å Bellz: Thisis the game project and listed under theGames folder of the 
solution, which holds the name of your game. Also you'll find this project 
has some base code files, Bui | der scripts, and theGameMode class. Those 
are there to make sure you've something that can run. 


Feel free to keep browsing bles, read the auto-generated comments, and learn 
more about them. Eventually, at certain points, we will have to go through 
almost all of those auto-generated bles and make some changes to some of 
the ples to bt our needs. 
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At the end of the day, the auto-generation process gives us the minimum necessary, 
and we will need to change and adjust that content to bt the game type we are 


processing. 


Solution Explorer 
@ e-o@ rja 


fg] Solution 'Bellz' (2 projects) 
Engine 
| UE4 
| Games 
%| Bellz 
Config 
| External Dependencies 
| Source 
Bellz 
c+ Bellz.Build.cs 
p Bellz.cpp 
B Bellz.h 
BellzGameMode.cpp 
D BellzGameMode.h 
c* Bellz. Target.cs 
c+ BellzEditor. larget.cs 


T: 
T 
T 

al 


T 


AL) Bellz.uproject 





Creating the C++ class 

When it comes to creating or adding a C+ class into your game, there are lots of 
ways you can do it. From the File menu you can choose New C ++ Class. However, 
the most common method is by just clicking on the big Add N ew button in your 
content browser and selecting New C ++ Class. 
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Using either way will add the new class into your Sour ce folder (revise the project 
directory structure in Chapter 1, Preparing for a Big Project) of your project. 


& AddWew-s =. Import H 


@ Add Feature or Content Pack... | 





By default, all C++ game projects will have a slightly different project structure, but 
most importantly, you will clearly see a section called C ++ Classes in the outliner of 
the content browser and a folder with the game name underneath it. This is where 
any new code þles should be by default. If you check this folder now from within 
the editor, you will pnd only one class whose name as game name +Ga me Mo de . This 
is an autogenerated class generated while creating the project. It is the prst and only 
class included with your project for now. 


D kaiek arch Bellz 


æ Content 
dps C++ Classes 


BellzGameMode 





Once you hit that magical button, you will be taken to the Add C ++ Class wizard. 
The prst screen of the wizard will ask you to choose a parent class. Any class you are 
going to create, most of the time should have a parent class, and | have to say that 
there are tons of full games that have been made without the need to create a class 
that is not inherited from a parent class of the unreal class list. 
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The parent class screen offers you the most important and the most common class 
types, but you also have the choice to pick a parent class from this list by marking 
the small checkbox at the upper-right that says Show All Classes. You will get access 
to the full class list for the engine. 


Let's just select the Character class type at the moment and that will show you the 
selected class sourceasSaCharacter.h ble If you are good, then let's proceed with 
the wizard by pressing N ext. 


AL Add C++ Class 


Choose Parent Class 


This will add a C++ header and source code file to your game project. Ø Show All Classes 


O None 


An empty C++ class with a default constructor and destructor 


š Pawn 


A Pawn is an actor that can be ‘possessed’ and receieve input from a controller 


@ Actor 


An Actor is an object that can be placed or spawned in the world. 
® Actor Component 
An ActorComponent is a reusable component that can be added to any actor. 


Selected Class Character 
Selected Class Source Character.h 


Cancel 





The second screen of the class wizard is the last screen of that short wizard. 

With this screen you can give a name to the newly created class and depnea path 
for it. | called my class GI adi at or ; feel free to use a name of your choice, but then 
make sure to correct your code while reading the code for the example project. 


The path of the class can be changed and you can set it in a different folder, 

but most of the time, and this is the most common behavior, you leave it as is and 
keep all the bles inside a folder named with the project name within the source 
folder of the project. 
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The main reason behind the process of having a game name folder inside the 
sources folder is that, in some cases, you will need to add extra code to the game 
that is not Unreal-related, possibly some code bles (headers of source ples) for an 
external library, a plugin, or maybe a server implementation for a multiplayer game, 
so thes ources folder should be organized for that reason. 


Another way people used to structure their code directory is by marking some 
classes aSpubl i c while marking others aspri vate. As you can seein the second 
screen of the wizard next to the class name, you can debne if the new class is going 
to be public or private; if you make this choice, Unreal will create a new folder of 
that type in order to have the class inside. 


If everything is OK, and you are good with the class name and the path, hit Create 
Class, and that will launch Visual Studio (or Xcode if you are on OS X) with the 
game solution loaded and the new class source ple and header ple opened for you. 


Al Add C++ Class 


Name Your New Character 


Enter a name for your new class. Class names may only contain alphanumeric characters, and may not contain a space 
When you click the “Create” button below, a header (.h) file and a source (.cpp) file will be made using this name. 


Path C:/Users/Muhammad/Desktop/Bellz/Source/Bellz/ Choose Folder 


Header File C:/Users/Muhammad/Desktop/Bellz/Source/Bellz/Gladiator.h 


Source File C:/Users/Muhammad/Desktop/Bellz/Source/Bellz/Gladiator.cpp 


Greate Class Cancel 





Keep in mind that all the code for this project was written at the 

s same time. The game was built before starting the process of writing 
Q this book so you might pnd some pieces of code that do not make 

any sense at the moment because it was written for use later on. 
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In areal game project you'll be building your game step by step and thecharacter 
class, for example, will not be done prst; you'll keep adding to it and improving it all 
the time. Because this is an educational book, and everything should be described in 
its own chapter, you will pnd almost all the pieces related to a covered topic within 
its own chapter. 


Editing and adding code 


After opening Visual Studio, you will have the base code for the header ble and 
thesources bleofthecharacter class we just created. This base code Is not 
essential; you can edit it or remove the majority of it, but for our game's purposes 
we will keep it. 


The header ble will usually look like this by default: 


DeltaSeconds ) 


SetupPlayerInputComponent i " InputComponent ) 





As you can see, header ples start with including the character header ble from the 
Unreal Engine game framework, and then include the generated header of the newly 
created class we Just made. 
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An Unreal Engine class should have the macro UCLASS above it, otherwise you will 
probably get a compiler error. 


The class, by default, will include several public functions that are, in order: 
A Constructor: Thisis necessary to hold any code that is used to build the 
class (or any blueprint based on that class) during edit time 


Begi nPI ay: The override of the virtual voi d Begi nPI ay class, which is going 
to be called once the game starts 


A 

Å Tick: Thisis also an override of a virtual void from the base class, and that 
method will be called every frame as long as the object exists 

A 


SetupPl ayer!l nput Component : Another override of a virtual function from 
the base class, and this one Is called to set up and map the key inputs (the 
ones we made in Chapter 1, Preparing for a Big Project) to the class 


In addition, the source ble for theG! adi at or class should have all the 
Implementations of those functions debned within the header ble. 
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The base code of the source ble is almost empty; it is just declarations for the 
methods. But one thing to notice here is that theobj ect constructor contains a 
Boolean value named Pri maryActorTick. bCanEverTick; setting ittot rue will 
make sure this object and all its instances use thet i ck function (called every frame). 
So if your class is not going to call a tick, or you want an easy way to disable a tick 
for a class and its objects, just mark this value asf alse. 


Vj g'l ref lewat’) gef gtd #Og 


Now let's jump back to the header ble again, and let's start adding some more 
functions and variables to it so we can start building gameplay logic for the character 
and make something that pts our target. 


Considering that a class based on FTab! eRowBase and called AGameDat aTabl es will 
be used later to read the gameplay data from Excel tables; here is the header ple code 
| ended up with. 


To make it easier to understand the code, | would like to breakdown all the variable 
components and methods into a set of chunks; that way it will be very easy to 
understand them. 


Everything starts with the includes, just like any form of C++ coding you are used to 
making, including the header ples that are going to be used or referenced and must 
be done at the top of the code. 


#pragma once 

#include "GameDataTables.h" 

#include "GameFramework/ Character. h" 
#include "Gladiator. generated. h" 


Debning the class itself is essentially a step directly after thei ncl ude statements. 


UCLASS(config = Game) 
class AGladiator : public ACharacter 


{ 
GENERATED_BODY( ) 


Begi nPI ay: This isthe virtual void of the overrideBegi nPI ay fromtheCharacter 
class base and this one will be called once the game is started. 


virtual void BeginPlay() override; 
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CameraBoom: ThisisauSpringArmComponent that will be added to the 
character blueprint that is based on that class. This component will be used 
to control the camera. 


//Camera boom positioning the camera behind the character 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Camera, meta 
= (AllowPrivateAccess = "true")) 


class USpringArmComponent* CameraBoom: 


Fol | owCamera: This is the camera itself that will be viewing the game and following 
the player. This one will also be added to the blueprints. 


// Follow camera 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Camera, meta 
= (AllowPrivateAccess = "true")) 


class UCameraComponent* Foll owCamer a; 


EffectSprite:ThisisaPaper 2D sprite component (Paper 2D is the main 2D 
framework for Unreal Engine 4.x). There are lots of ways we can use this to achieve 
an on-screen draw texture, but this one is the easiest and most yexible. | managed 
to add a sprite component that is very close to the camera, and then we can use it to 
draw whatever effect we need. 


//The sprite used to draw effect, better and more contrallable than 
using the HUD or Textures 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Effects, meta 
= (AllowPrivateAccess = "true")) 


class UPaperSpriteComponent* EffectSprite; 


AGI adi at or : This is the constructor, and as mentioned earlier, it is used to build the 
object in edit mode. 


public: 
AGl adiator(); 


BaseTurnRate: Thisisaf!oat variablein degrees to control the camera turn rate. 


//Base turn rate, in deg/sec. Other scaling may affect final turn 
rate 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Camera) 
float BaseTurnRate: 
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BaseLookUpRat e: Anotherf! oat variable to control the camera, but this time it's for 
lookups. This one is also in degrees. 


//Base look up/down rate, in deg/sec. Other scaling may affect final 
i a oa 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Camera) 
float BaseLookUpRate; 


JumpingVelocity: Thisisafl oat variableto determine the jump velocity. 


//Base Jump velocity 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Player 
Attributes") 


float jumppingVelocity; 


IsStil I Alive: Thisis a Boolean variable to tell us what the current state of the 
layer is. It is avery important variable, as most of player behavior and inputs will be 
based on it. 


//ls the player dead or not 


UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Player 
Attributes") 


bool IsStillAlive: 


| s At tacking: Another Boolean variable to report if the player is attacking now or 
not. It is important for animations. 


//is the player attacking right now? 


UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Player 
Attributes") 


bool IsAttacking; 


Weaponl ndex: Thisis an integer to determine the current active weapon index. The 
player could have several weapons; to be able to load the weapon's data, it is a good 
idea to give each weapon its own index. 


//the index of the current active weapon. 


UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Player 
Attributes") 


int32 Weaponl ndex; 
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|sControl abl e: Sometimes the player is not dead, but you also need to take the 
control out of his hands, maybe because the character is carrying out an attack, 
or maybe because the player paused the game. So this is aboo! variable meant 
to tell us if the player is in control now or not. 


/[/To be able to disable the player during cutscenes, menus, death... 
etc 

UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Player 
Attributes") 

bool IsControl able; 


Tabl esi nstance:A dat at able variable to hold the active instance of the game 
tables. It is just here to load some data. 


UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Game 
DataTables") 
AGameDataTables* Tablesinstance;: 


Get! sStillAlive:A getter method to return the value of thel sStill Alive 
Boolean variable. 


//Return if the player dead or alive 
UFUNCTION( BlueprintCallable, Category = "Player Attributes") 
bool GetIlsStillAlive() const { return IsStillAlive; } 


OnSet Pl ayerController:A method that takes a parameter of true orfalse,and 
uses it to set the status of the player controller. So it is here we take the control from 
the player, or give it to him at a certain moment. 


//Enable or disable inputs 
UFUNCTION( BlueprintCallable, Category = "Player Attributes") 
vold OnSetPlayerController(bool status); 


OnChangeHealt hByAmount :A method that takes af | oat value, and reduces the total 
player health using it. It is usually used when the player gets damaged. 


//the attack effect on health 
UFUNCTION( BlueprintCallable, Category = "Player Attributes") 
void OnChangeHealthByAmount(float usedAmount); 


OnGetHealthAmount: Thisisagetter function that returns theTot al Health value 
of the player asaf | oat value. 


UFUNCTION( BlueprintCallable, Category = "Player Attributes") 
float OnGetHealthAmount() const {return Total Health; } 
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OnPostAttack:A method that holds some procedurals after the player has done 
an attack. 


UFUNCTION( BlueprintCallable, Category = "Player Actions") 
void OnPostAttack(); 


Get CameraBoom:A gett er method to return theCa mer aBoom component variable. 


//Returns CameraBoom subobj ect 


FORCEINLINE class USpringArmComponent* Get CameraBoon ) 
const { return CameraBoom; } 


Get Fol | owCamera: Another get ter method to return theF ol | owCamer a 
component variable. 


//Returns FollowCamera subobj ect 


FORCEI NLINE class UCameraComponent* GetFoll owCamera() 
const { return FollowCamera; } 


MoveFor ward:A method that holds the code responsible for player movement 
to the forward and backward. Noticethat itisaBl ueprintCallable inorder 
to be able to use it from theG! adi at or class blueprint instances. 


protected: 
UFUNCTION( BlueprintCallable, Category = "Player Actions") 
void MoveForward(float Value): 


MoveRi ght :A method that holds the code responsible for player movement to the 
left and right. 


UFUNCTION( BlueprintCallable, Category = "Player Actions") 
vold MoveRight(float Value); 


J ump : A method that is responsible for applying the jump action to the character 
based on the base character class. 


UFUNCTION( BlueprintCallable, Category = "Player Actions") 
void Jump(); 


Stop} umpi ng: A method that is responsible for stopping the jump, and resuming the 
idle/ run animation. 


UFUNCTION( BlueprintCallable, Category = "Player Actions") 
void Stop} umping(); 
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OnAt tack: A method that is responsible for attacking. 


UFUNCTION( BlueprintCallable, Category = "Player Actions") 
void OnAttack(); 


OnChangeWeapon:A method that is responsible for switching between weapons. 


UFUNCTION( BlueprintCallable, Category = "Player Actions") 
void OnChangeWeapon( } : 


TurnAt Rat e: A method that is responsible for applying turns to the following 
camera. 


//Called via input to turn at a given rate. 
vold TurnAtRate(float Rate); 


LookUpAt Rat e: A method that is responsible for applying the camera look-up rate to 
the follow camera. 


//Called via input to turn look up/down at a given rate. 
void LookUpAtRate(float Rate); 


Total Health:Afloat variable that holds the player's total health (the current 
health), as at any moment the player's health gets reduced, that will be the pnal 
value. Some people like the approach of creating two variables: 


A Total Health: Thisis the base and default health 
Å CurrentHeal th: This represents the current health status 


Feel free to use any approach you want, but | like to make one health variable for 
such a small game. 


//The health of the enemy 

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
"Player Attributes") 

float Total Health; 


AttackRange:Afl oat variable that holds the current weapon attacking range. 


//The range for the enemy attack 

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = 
"Player Attributes") 

float AttackRange; 
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SetupPl ayer!l nput Component : Another override of a virtual function from the base 
class, and this one is called to set up and map the key inputs (the ones we made in 
Chapter 1, Preparing for a Big Project) to the class. 


protected: 
//APawn interface 
virtual void SetupPlayerl nputComponent(class Ul nput Component * 
I nputComponent) override; 
//End of APawn interface 


E 


As you can see, there are some stylings that have been applied to the code. It looks 
weird, strange, and unique at þrst glance, but once you get used to writing Unreal 
code you'll get very familiar with these things. 


The styling | used involved some access specibers and macros, which include: 


Å Public:Any variables or methods listed underneath this access specifier will 
be public 


Å Private: Any variable or method listed underneath this access specifier will 
be private 


Å UPROPERTY: ThiSis used before a variable and is a macro to define attributes 
for the variable, such as how and where it should or could be changed or 
seen, and its category to make sure it is listed in the correct place 


Å UFUNCTI ON: Thisis used only before a function and is a macro to define 
attributes for a function, such as how and where it should or could be called, 
and its category to make sure It is listed in the correct place 


Vj g'l ref lcvgt'uqweg"@rr+Og 
Because source bles always contain more than 20x more code than the header ples, 


| would like to follow a different approach here in explaining the code. | will break 
down the source ble into blocks, one by one. 


The includes 


As we mentioned earlier, any C++ ble or even header ple must start with the 
incl ude statements. You don't have to include everything; some of thei ncl ude 
statements will be there by default but others might be needed while you are 
building up the code. 
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Even if your game example is different and you wanted to have different 
functionalities, you might need to include more headers. 


#include "Bellz. h" 

#include "Gladiator. h" 

#include "“GameDataTables.h" 
#include "PaperSpriteComponent. h" 
#include "“GameDataTables.h" 


As you can see, now the included header ples have been increased to include those 
we have formed from the auto-generated source ple. 


Because the game will be reading data from Excel sheets, | managed to import the 
GameDat aTabl es header ble, so wewill be able to deal and work with the data table 
classes. For the same reason, | managed to import theGame Dat aTabl es header ple, 
so well be able to get the data through the object instance of the data itself. 


Because we've made aS pri te2D component within the header ple, | needed to be 
able to control this sprite at any given moment and also needed to be able to control 
anything related to this sprite component at the constructor while building our 
character. To be able to do all of that, | need to be able to access that component, 
which can be done through thePaperSpriteComponent header ple. 


Keep in mind that, if you are not able to load this header ple, it might be because 
Paper2D is notin youri nc! ude path, so you need to add several additional i ncl ude 
paths in the project settings of your game project. 


C:\Program Files (xé6)\Epic Games\4.10\Engine\Plugins\2D\Paper2D\ Source’ Paper2D\ Classes 
C:\Program Files (x86)\Epic Garnes\4.10\Engine\Plugins\2D\Paper2D\ Source Paper? O Public 


C:\Program Files (x86)\Epic Garnes\4. 10\Engine\Plugins\2D\Paper2D\ Intermediate’ Build\ Wint UE4Editor\Inc\Paper2D 
C\Program Files (x86)\Epic Games\4. 10\Engine\Plugins\2D\Paper2D\Source\Paper2D 





The constructor 


You might be familiar with the term constructor. It has exactly the same function 
within Unreal games. It will be execute the set of commands you enter once the 
object instance has been created. 


AGladiator::AGladiator() 
{ 


//Set size for collision capsule 
Get CapsuleComponent()->IlnitCapsuleSize(42.f, 96.0f); 
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Total Health 100. f; 
AttackRange = 25.f; 


jumppingVelocity = 600.f; 


//set our turn rates for input 
BaseTurnRate = 45.f; 
BaseLookUpRate = 45.f; 


//Don't rotate when the controller rotates. Let that just affect the 
Camera. 


bUseControllerRotationPitch = false: 
bUseControllerRotationYaw = false: 
bUseControllerRotationRoll = false: 


//Configure character movement 


GetCharacterMovement()->bOrientRotationToMovement = true: // 
Character moves in the direction of input... 


GetCharacterMovement()->RotationRate = FRotator(0.0f, 540.0f, 0. 0f): 
I] ...at this rotation rate 


Get CharacterMovement()->JumpZVelocity = jumppingVelocity:; 
Get CharacterMovement()->AirControl = 0. 2f; 


//Create a camera boom (pulls in towards the player if there is a 
collision) 


CameraBoom = CreateDefaultSubobj ect <USpringArmComponent >( TEXT( "Came 
raBoom")); 


CameraBoom- >AttachTo(RootComponent); 


CameraBoom- >TargetArmLength = 300.0f; // The camera follows at this 
distance behind the character 


CameraBoom- >bUSePawnControl Rotation = true: // Rotate the arm based 
on the controller 


//Create a follow camera 


FollowCamera = CreateDefaultSubobj ect <UCameraComponent >( TEXT("Follo 
wCamera')); 

FollowCamera->AttachTo(CameraBoom, USpringArmComponent:: Socket Name); 
// Attach the camera to the end of the boom and let the boom adjust to 
match the controller orientation 

FollowCamera->bUsePawnControl Rotation = false; // Camera does not 
rotate relative to arm 
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EffectSprite = CreateDefaultSubobj ect <UPaperSpriteComponent >( TEXT(" 
ClawEffect")); 
EffectSprite->AttachTo( CameraBoom) ; 


//Note: The skeletal mesh and anim blueprint references on the Mesh 
component (inherited from Character) 

//are set in the derived blueprint asset named MyCharacter (to avoid 
direct content references in C++) 


IsStill Alive = true: 
|sAttacking = false: 
Weaponlndex = 1; 


//by default the inputs should be enabled, in case there is 
Something ned to be tested 
OnSetPlayerController(true); 


} 


Inside the constructor, we have to put all the logic that will be applied directly 
in the following three cases: 


Å If you switch back directly to the editor after writing the code, you 
should see that the changes that have been made inside the constructor 
have already taken place 


A Once you create a blueprint based on the class, all the code within the 
constructor will be executed after creating the blueprint instance in the editor 


Å Onceyou spawn a blueprint based on the class at runtime (while the game is 
running), all the constructor logic will already have been applied (unless you 
changed it inside the editor) 


Because of the nature of the constructor, | managed to put any default value, add 
any default component, or add any default objects, inside it. As you can see from 
the constructor logic, | have done the following, in order: 


Å Applied a size (width and height) to thecaps ul e component of the 
character Class. 


Å Added adefault value of 100 to the total health variable holder, and added 
a default value of 25 to the attack range variable. 


Å Applied ajump velocity to the character (this value is inherited from the 
base character class). Feel free to experiment with values, | found 400 to600 
works well for me. 
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Applied default values for theBaseTurnRate and theBaseLookupRate 
values, so | now have some values to control the camera when necessary to 
control it. The higher the values, the faster the camera moves; the lower the 
values, the slower the camera moves. 


Then | worked on applying values to some of the default members of the 
character base class. Those values include: 


° =Settingboo! Ori ent Rot ationToMovement to true; that way | make 
sure the character mesh will be rotated in the direction of the 
movement 


° ~—Settting Rot ati onRate variable to make the default rotation rate for 
the character 


° Applying the default velocity value we stored earlier to the 
JumpZVelocity variable 


° Adding someAi r Cont ro! valueto make sure the character behaves 
well 


Then | started to work with the spring arm component called Camer aBoom 
that we declared within the header file. | started by creating the component 
itself, to add it to a category of its own name. Then | attached it to the root of 
the object, added aTarget ArmlLengt h value of 300 toit, and finally | set the 
Boolean named bUsePawnControl Rotation totrue to make sure that the 
spring arm will be rotated based on the controller. 


While I'm creating the new components and applying some parameters to 
them, it is time to create the camera and attach it to the player controller. 
After creating the camera component asFo! |! owCamer a and assigning it to 
a category, | attached it to the spring arm component (as a child) and finally 
disabled itsbUsePawnControl Rot ati on component to make sure that the 
camera doesn't rotate relatively to the soring arm component. 


Now | have created a paper sprite component (Paper 2D) and assigned it to 
the Ef fect Sprite component; that way | make sure it will always be rotated 
with the mouse/ gamepad, which applies the camera rotations based on the 
Camer aBoom component attached to the player. 


Then | set some of the variables | have to their default values, including the 
Boolean! s Stil! Alive tomark the player as alive at the beginning, and 
then | set the value of the! sAt tacking variable tof alse, because it makes 
sense that, once the game starts there is definitely no attack! Finally, | set the 
Weaponl ndex component to the first weapon | want to be used. 
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Å Finally, wecall the method, OnSet Pl ayerController and passat rue value 
to it to make sure that once the game starts, the player, by default, has control 
over the camera. This could be changed later based on the level, the scenario, 
and so on. 


BeginPlay 

BeginPlay isalittle different to OnConst ruct , which Is the constructor executed 
once the object has been created, which means it is executed either once the instance 
has been made at runtime, or inside the editor while building the game. Begi npl ay 
is only executed at the start of the game, or once the object is instantiated at runtime, 
as long as it has never been executed inside the editor. 


void AGladiator:: BeginPl ay() 
{ 
//Ask the datamanager to get all the tables datat at once and store 
them 
//AGameDataTables dataHol der; 
for (TActorlterator<AGameDataTables> Actorltr(GetWorld()); Actorltr; 
+tActoritr) 
{ 
if (Actoritr) 
{ 
//print theinstance name to screen 
//GEngine- >AddOnScreenDebugMessage(-1, 10.f, FColor:: Green, 
Actor|ltr->GetName() }); 


//Call the fetch to the tables, now we get all the datat stored. 
Why? simply because keep readin everytime fromthe table itself is 
going to cost over your memory 

//but the most safe method, is just to read all the data at 
once, and then keep getting whatever needed values fromthe storage 
we've . 

Tablesinstance = *Actorlitr; 

Tabl esl nstance- >OnFetchAl!Tables(); 
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BecauseBeginPl ay() isthe prst thing to take place for the class instance once the 
game runs, | didn't have much to do for now except getting the current data table 
instance from the level so | can store it and use the data from it. Some of the data is 
useful for the player, such as the weapons data, and that made It important to keep 
an instance of it inside the player controller. 


Using theTActorlterator type was my choice, as it is the best way yet within 
Unreal to look for objects of an X type within the level. | used it to look for the type 
AGameDat aTab! es, which is a class type we are going to create later, and once | 
found it, | called its member function OnFet chAl | Tables which will get all the 
table data and store It. 


Feel free to comment this part, and not even use it until you reach the data 
table chapter. It might make more sense there but again, it makes the game go 
back and forth between classes. H owever, each chapter here has to be as 
independent as possible. 


SetupPlayerInputComponent 

This is one more default method that Unreal adds by default you can totally 
ignore calling it at all, but as long as we have inputs required it is the best place 
to bind them. 


void AGladiator::SetupPlayerlnputComponent(class Ul nput Component * 
Input Component) 


{ 

//Set up gameplay key bindings 

check(I nput Component); 

Input Component->BindAction( "Jump", IE Pressed, this, 
&ACharacter::] ump) : 

Input Component->BindAction( "Jump", IE Released, this, 


&ACharacter:: Stop] umpi ng); 


Input Component->BindAction( "Attack", IE Released, this, 
GAGI adi ator: : OnAttack) 

Input Component->BindAction("ChangeWeapon", IE Released, this, 
GAG] adi ator: : OnChangeWeapon) ; 


Input Component->BindAxis("MoveForward", this, 
GAG! adi ator: : MoveFor ward) : 
Input Component->BindAxis("MoveRi ght", this, &AGladiator:: MoveRi ght); 
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//We have 2 versions of the rotation bindings to handle different 
kinds of devices differently 


//"turn" handles devices that provide an absolute delta, such as a 
mouse, 


f{/"turnrate" is for devices that we choose to treat as a rate of 
change, such as an analog joystick 

Input Component->BindAxis("Turn", this, 
&APawn::AddControllerYawl nput) : 

Input Component->BindAxis("TurnRate', this, G&AGladiator::TurnAt Rate); 

Input Component->BindAxis("LookUp", this, &APawn::AddControllerPitch 
Input); 

Input Component->BindAxis("LookUpRate", this, 
GAGI adi ator: : LookUpAt Rate) ; 


} 


SetupPl ayer! nput Controller isone of the most important functions from the base 
character class. This is the function responsible for assigning the keys from the input 
settings (the ones we set in Chapter 1, Preparing for a Big Project, inside the project 
settings), to functions within this class (or maybe other classes if you wish). 


As you may remember, we added two types of key input in Chapter 1, Preparing for a 
Big Project , which were: 


Å Actions 
Å Axis 


Now, it is time to bind the inputs and in order to do this we use a function based on 
the key input type, and that means that, as we have two key input types, we also 
have two types of binding functions: 


Å BindAction 
Å BindAxis 


Both interfaces look the same; you have to pass the key name that we have 

depned inside the input settings and pass the function that should be called in 

that input event. It is not only everything that you can pass, but also a specipc type 
of the input event. For example, you can pre the function on when the input key is 
released or pressed. 
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Jump 


This is avery short, but useful function. Lots of people used to map thej ump 
function with the key intheSet upPl ayer! nput Component directly, but! always 
like to have an independent function for jump processing. 


void AGladiator::]ump() 
{ 
if (IlsControlable && !IsAttacking) 
{ 
bPressedj ump = true: 
JumpKeyHol dTime = 0. Of; 
} 
} 


As you can see, | made sure prst that the player is in control and is not in attacking 
mode. If both conditions are met, then | can go ahead and change some parameters, 
which will apply the jump directly from the character base class. 


StopJumping 

When ajump takes place, lots of things will depend on it. Some logic will be 
executed but, most importantly, animations will be played based on that action. 
That is the reason behind adding another function to be called when ajump Is 
done, because other animations will need them. 


void AGladiator:: Stop] umpi ng() 
{ 
if (lsControlable) 
{ 
bPressedj ump = false; 
JumpKeyHol dTi me = 0. Of; 
} 
} 


ThesSt op} umpi ng function is not very complex, and in fact it only does the exact 
opposite of thej ump function. 
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OnAttack 


While there isn't too much to do when the player hits the Attack button, 
changing the status of the attack itself is enough to drive the animations 
inside the animation blueprint. 


void AGladiator:: OnAttack() 


{ 
if (IlsControl able) 


{ 


lsAttacking = true; 
} 
} 


ThednAt tack function is simple here, as it is only going to set the Boolean value of 
the attack tot rue. This value is going to be used from the animation blueprint in 
order to display the attack animation. 


The attack effect itself is measured by the overlapping spheres of the weapons and 
that's the reason behind not having too much logic within the attacking function. 


OnPostAttack 


Here is another reverse of a function; a function that is only doing the opposite of the 
previous function. 


void AGladiator:: OnPostAttack() 
{ 


lsAttacking = false; 
} 


A good implementation to be used here is to make them both one function with 

a Boolean parameter to be passed. Then, based on the case, we pass at rue or 
false value. But! prefer to make both separate functions, just in case | need to add 
something special for either of the two functions. 
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OnChangeWeapon 


Sometimes in such a game, the player needs to switch between weapons; this might 
make more sense with a very large game with tons of different weapons, but | 
wanted to add it herein a minimal fashion as it is Sometimes essential to have it. 


void AGladiator:: OnChangeWeapon( |) 
{ 

if (IsControlable) 

{ 


if (Weaponlndex < TablesIlnstance- >All WeaponsData. Num) ) 
{ 
Weaponl ndex++; 
} 
else 
{ 
Weaponlndex = 1; 
} 
} 
} 


The main idea here is that, whenever the player switches between weapons, all that 
we do is change the weapon index, and based on that index we can: 


Å Load a different weapon mesh 


Å Load different weapon data from the data tables (information that includes 
the weapon's name, icon, damage, and so on) 


So as you can see, every time the player hits the Change Weapon key, this function 
gets called. The function is very simple. It checks thecurrent weapon index 
variable and, as long as it is less than the amount of the weapons found on the game 
data table, itaddsltothecurrent weapon index variable. If itis not, then it sets 
theweapon index variableto1 to start from the prst weapon in the table again. 
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TurnAtRate 


This is one of the functions mapped to a certain input. Its main job it to rotate the 
camera up and down, but the good part of it is that it is mapped to ready-made code 
from the Unreal EngineCharacter class. 


void AGladiator::TurnAtRate(float Rate) 
{ 
if (IlsControl able) 
{ 
//calculate delta for this frame fromthe rate information 


AddControllerYawlnput(Rate * BaseTurnRate * Get Worl d()- 
>Get Del taSeconds()); 


} 
} 


The base character class has a method called AddControllerYawl nput .Itis meant 
to apply a yaw rotation to the controller. Here we make sure this method Is going to 
be called when the proper input calls the Tur nAt Rate method and applies it to the 
value of theBaseTurnRate yoat we have created in the header ple. 


LookUpAtRate 


As we mapped some keys to move the camera up and down, it makes sense to add a 
similar functionality to move the camera from side to side: 


vold AGladiator::LookUpAtRate(float Rate) 
{ 
if (IlsControl able) 
{ 
/i/calculate delta for this frame fromthe rate information 


AddControllerPitchIl nput(Rate * BaseLookUpRate * Get Worl d()- 
>Get Del taSeconds()); 


} 
} 


We are going to do with the pitch as we did with the yaw. The base character 
class has a method called AddControllerPitchlnput to apply a yaw rotation to 
the controller. H ere we make sure that, every time this method is called, when 
the proper input calls theTur nAt Rate method and applies it to the value of the 
BaseLookUpRat e yoat we have created in the header ple. 
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OnSetPlayerController 


This simple function is very effective as it is going to control almost all player inputs. 
This function's main job is to change the value of the Boolean called! sControlable. 
The value of this Boolean is checked before any player input to verify whether the 
player has access to the Input or not; based on that, the game will process the player 
input and translate it to functions. 


void AGladiator:: OnSetPlayerController(bool status) 
{ 
IsControlable = status; 


} 


For example, this function is called by the end of the constructor with the value of 
true to make sure that, once the object instance is created, the player has control 
over it. At the same time, when the player tries to do any input, such as attack, you'll 
pnd that theat tack method called AGI adi ator: : OnAt t ack() does nothing before it 
checks for the Boolean! sControlable toseeifitistrue orfalse. 


OnChangeHealthByAmount 


N ow let's do something interesting. It is not only interesting because we are going to 
do a math function that will decrease and increase the player health, but also because 
it will be calling a function from the blueprint, yes, C+ code calling blueprint logic! 


void AGladiator:: OnChangeHealthByAmount(float usedAmount ) 
{ 

Total Health -= usedAmount; 

FOutputDeviceNul!l ar; 


this->CallFunctionByNameWithArguments(TEXT( "Appl yGet DamageEffect"), 
ar, NULL, true); 


} 


The player health by default is 100, stored in the variable named Tot al Heal th; this 
value is not going to stay as is during the gameplay. 


The player has to take some damage from the enemy's attacks and eventually lose 
some health. Or maybe you want to add some new features to the game such as 
health pickups; then you need a quick way to be able to change the current health 
value, which will be eventually displayed through the UI. 
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That's the main job of this function: it takes a speciped amount of health, and 
subtracts it from the main health. 


As you can see, there is a call for an internal function being made using the method 
Call FunctionByNameWi t hAr guments; this means that the C++ code is going to call 
the blueprint function. 


Let's be clear, anything that can be done using C+, can be done using blueprints, 
but sometimes accessing components and applying some settings is easier via 
blueprints. The idea here was to present a way that you can call a blueprint function 
from within the C++ code. 


The function being called here, which is called Appl yGet DamageEf f ect , is meant to 
display an overall screen effect that shows that the player has taken some damage at 
that moment. We will build its logic in the blueprint later in this chapter, but let's be 
clear about what exactly this function is going to do In order: 


1. Get thelevel post-processing volume that is dedicated to displaying the hit 
effect and save a reference to it so it becomes easier and faster the next time 
we call the function, as we will already have a reference for the volume and 
then will display this volume effect. 


2. Getthes pri te component we created in the header ble, enable it, and play 
some fade animations for it. So yeah, making fade effects based on af | oat 
value is a lot easier through blueprints and timeline nodes. 


3. Finally we create some camera shakes to simulate the damage to the player. 


Once were done with the C++ code and have created our blueprint based on that 
class, we will be working on beautifying it and adding some blueprint logic. That's 
where we will implement the logic for theApp! yGet DamageEf f ect method. 


MoveForward 


Now we cometo avery important part of the controller system, where we will 
be writing the code to move the player forward and back, using the keys we have 
mapped earlier at the top of the class. 


void AGladiator::MoveForward(float Value) 


{ 
if ((Controller != NULL) && (Value != 0.0f) && IsControlable && 
I] sAttacking) 


{ 
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//find out which way is forward 
const FRotator Rotation = Controller->GetControl Rotation(): 
const FRotator YawRotation(0, Rotation. Yaw, 0); 


[i get forward vector 


const FVector Direction = FRotationMatrix(YawRotation). 
GetUnitAxis(EAxis::X): 


AddMovementI nput(Direction, Value); 
} 
} 


TheAGl adi ator: : MoveForward function is called when themove forward input 
key is triggered. This function has to prst check whether the controller exists, and 
the value of the movement is not 0, as well as whether the player has control now 
or not. Finally, it checks to see whether the player is not in attacking mode. If all 
the conditions are met, then the function will get the rotation of the controller and 
the yaw rotation of the controller, and that's very important information in order 
to decide which forward direction will be used to move. 


After getting the direction and storing it as a vector as the Di rection variable itisa 
good time to apply the movement using the base class method, Add Movement Input, 
to apply the movement with the value that came from the input key, and the 
direction we just calculated. 


Understand that the value passed might be positive or negative, and that will depne 
the direction: forward or backward. 


MoveRight 


As weve created a function to move the player along the front-back axis, we have to 
create another one for the side to side movement. 


void AGladiator::MoveRight(float Value) 
{ 
if ((Controller != NULL) && (Value != 0.0f) && | sControlable && 
I] sAttacking) 
{ 
//find out which way is right 
const FRotator Rotation = Controller->GetControl Rotation(): 
const FRotator YawRotation(0, Rotation. Yaw, 0); 


[53] 


Seting Up Y our Warrior 


//get right vector 
const FVector Direction = FRotationMatrix(YawRotation). 
Get UnitAxis( EAxis:: Y); 
//add movement in that direction 
AddMovementI nput( Direction, Value); 
} 
} 


ThedAGl adi ator:: MoveRi ght function is called when themove right input key 
is triggered. This function has to check prst whether the controller exists and the 
value of the movement is not 0, as well as whether the player has control now or 
not. Finally, it checks to see whether the player is not in attacking mode. If all the 
conditions are met, then the function will get the rotation of the controller and 

the yaw rotation of the controller; this is very important, in order to decide which 
direction is the right way to move. 


Aswith themove forward function, after getting the direction and storing it asa 
vector as theDi rection variable, itis agood time to apply the movement using the 
base class method called AddMovement Input with the value that came from the input 
key, and the direction we just calculated. 


Understand that the value passed might be positive or negative, and that will depne 
the direction: right or left. 


Compiling the code 


Now with everything done for the controller, you're ready to jump back to the editor 
to make use of it. In order to have the code we made executed by the editor, you 
need to compile it prst. Otherwise, the game will keep behaving as if this code has 
never been added. 


There are different ways you can use to do that, both accessed from a different place. 
So you can: 


Å From within the Visual Studio itself, right-click on the game project from the 
Solution Explorer window and hit Build, and that will do the build for you. 
If there are any errors, you'll see them in the output panel; otherwise, you 
will get a success message. 
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Solution Explorer 
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Å From within the Unreal Editor itself, you can simply hit the Compile button 
from the top bar. If there are code errors, Unreal will show you a failed 
message with a failed sound effect. 


= ag F y! 


A 


Compile 





But anyways, regardless of the method you used, if compilation takes quite some 
time you can still make it faster as you can copy Bui | dConfi guration. XML fromthe 
unreal Engine installation directory (for example):C:\ Program Files (x86)\ Epic 
Games\4.10\ Engi ne\Programs\ Unreal BuildTool. 


Paste it in your Unreal Engine documents folder (for example): C: \ Users\ <user >\ 
Documents\Unreal Engine\Unreal BuildTool\. 


The last step is changing a small value from this XML ple, which ts 
ProcessorCount Multi plier,to2 or4 issettol by default. 


<ProcessorCount Multi plier>1l</ProcessorCount Multi plier> 
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Animation assets 


Even after we have made all the code we need, it is still not enough to get the 
character running in the game; and doing exactly what the code is saying. The code 
is just a way to do things, but in order to see it needs some way of being visualized. 


In Chapter 1, Preparing for a Big Project, we managed to import some of the free assets 
to the game, one of those assets was the warriors in the free packages from Unreal 
Marketplace. If you haven't added it to the project, then follow the steps we have 
used in Chapter 1, Preparing for a Big Project, and add those characters to the game. 


Infinity Blade: Warriors 





Adding sockets to the skeleton 


Double-click on the character you want to use in order to open it in the animation 
editor, Persona, and there you need to switch to the Skeleton tab in the upper-left 
corner. From there, you have access to the entire skeleton. 


Because | Know that my player will be using his right hand to hold weapons, 
| wanted to visualize this so it becomes very easy for me to understand how, 
exactly, the animation looks. 


Select the hand_r joint from the bones list and by right-clicking you can choose Add 
Socket; this will add a socket that can hold items. | named my sockets wor d, name 
the one you made as you wish! 


F j Selected Bone Actions 
Copy Selected Bone Names 


Ai Reset Selected Bone Transforms 
| 


Paste Selected Sockets 
Attached Assets Actions 


Add Preview Asset 





Remove All Attached Assets 
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Now you right-click again, but this time on the socket itself (the socket we have just 


created), and choose to Add Preview Asset. 


That will open a small menu for you to choose an asset to use as a preview. Pick 
one choice but keep in mind that the asset you choose will only bea preview, only 
appears inside the character editor, and will not be spawned in-game, or even in 
any other editors; it is just a preview asset to test your animations. 
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Keep moving the socket, and position and rotate it until you get a good result. It has 
to be very accurate, as this position will be used later to hold weapons. 


 —_—_— 




















Creating the blend space 


Now itis time to create the animation blueprint. In order to be able to create 
the fully working animation blueprint we still need to create one more thing: 
an animation blend. 


The animation blend is meant to implement a blend between several animations, 
and the goal we want to achieve here is to blend between the idle, walk, and run 
animations. 


Using animation blend is one of the most fun, yet simple, tasks you can do with 
Unreal Editor. By simply creating an animation blend 1D asset from the content 
browser, you are half-way there. 


Right-click inside the content browser and choose Blend Space 1D from the 
Animation section; this will pop up a window for you to choose the targeted 
character skeleton. Choose it, and name the animation blends as you wish. 
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Blueprints 

Materials & Textures 
Sounds 

Physics 

User Interface 
Miscellaneous 
Blendables 


Paper2D 





Animation Blueprint 


Animation Composite 


Animation Montage 


Blend Space 


Open the animation blend space. The way it works is that a vertical line in the 


middle represents the blend over time. 


On the right-hand side you can see all the animations listed for the character; by 
simply dragging and dropping animations into the space, you are assigning them. | 
simply put the walk animation at the bottom and the running animation at the top, 
then the walk animation in the middle, but shifted it a little to the bottom to make 
sure the blend between the idle and walk is quick, but the blend between the running 


and walk takes more time and inputs. 


X 
[100.00] Previewing 
None [98.947] 


ThirdPersonRun (0.9860) 
ThirdPersonWalk (0.0140) 


4 Parameters 
x Axis Labe! None 
Apply Parameter Changes ' 


4 Samples 
To replace sample, you can drag animation onto the 
sample point in the BlendSpace from Asset Browser or 
replace in the list below 
1]ThirdPersonidle Dex 
2} ThirdPersonWalk Dex 
3] ThirdPersonRun Dex 


Remove all samples 


Enable Preview BlendSpace 


Enable Tooltip Display 


Display editor vertically 





If everything is OK and you like the result then hit Save and Close this Editor 
window, as we are going to create the animation blueprint. 
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The animation blueprint 


As the name implies, the animation blueprint is a way to handle the relationship 
between animations in the form of diagrams, charts or whatever you call it. 


Creating an animation blueprint asset is as easy as creating the blend space. From 
the same animation section of the contextual right-click menu of the content browser, 
you can choose Animation Blueprint. 
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The animation blueprint is a special type of blueprint; however as long it has the 

word blueprint in it, this means that it has to share some characteristics of the normal 
blueprint. This means that the animation blueprint not only contains a bunch of 
animation nodes, graphs, and state machines, it also has variables, functions, events, 
and almost anything you can pnd within atypical blueprint, such as an actor blueprint 
for example. 





Because the best use of the animation blueprint is to utilize almost each section of it, 
which means a huge part of the animation handling process will be involving code 
or logic creations, in order to do that | managed to add some variables that will be 
used to build the logic. 
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Those variables are: 


Å indir: Thisis a Boolean variable that gets the in air value from the character 
Class. 


Å movement Speed: Thisis a float variable that is going to control the movement 
speed; based on that, we will be handling the animation blend space we 
made earlier in the previous step. 


Å isAttacking: Thisis a Boolean variable that stores the original value we get 
from the gladiator class. 


A isStilAlive:Thisis a Boolean variable that stores the original value we get 
from the gladiator class. 


Å attackAni mati onl ndex: Because l'm planning to have more than just an 
attacking animation, | wanted to have an integer index; based on that index 
l'Il be loading a certain animation. We are going to add logic to randomly 
give an index. 


4 Variables 
inÄiT 
movementSpeed 


isAttacking 
isStilAlve 
attack Animationindex 





Once everything is alright, we can start building some logic within the animation 
blueprint. This logic will be mainly focusing on updating some statues and storing 
values inside the previously created set of variables. 


m n n a l s wrar a a 
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The logic is simple! As you can see, all that it is doing is getting the character 
controllers that are using this animation blueprint instance, and then getting the is 
falling status and applying it to the local variable inAir, and then doing the same 
thing with the velocity but applying it to the local variable movement Speed. Finally it 
calls a custom event called Updat eSt aut s. All this happens with every single frame. 


The U pdate Status event is not doing anything special, in fact, it is doing almost the 
same thing, but this time it is not accessing the character controller; instead, it accesses 
the gladiator class of the character that is using this animation blueprint instance. 


Then it gets thei s Attacking and thei sStil! Alive values from there and assigns 
them to the local variables. Finally, it makes a random number between two values; 
the maximum value matches the number of the attacking animations | want to 
shufye between. 


So, why do we get all those values and store them in local variables? 


The answer is simple. In order to apply a certain animation at a certain moment, 
we have to deþne some conditions for it, and this is how the state machines work: 
once a condition takes place, the animation blends from one state to another based 
on that condition. 


(= 


SET 
SSE & è 
© UpdateStatus >> Cast To Gladiator Ba Is Attacking | = Ka Branch 
> 


Cast Failed D Target Is Attacking Is Still Alive Condition False D 


True > 


As Gladiator 
Target Is Still Alive 
“F Try Get Pawn Owner 
Attack Animation Index 
Target [self] Return Value 


Er Random Integer in Range 


Min (7 ] Return Value 


Max [8 | 





The last, but not least, piece of logic is to tell the code that the attack animation is 
done, by calling the OnPost At tack method we made earlier inside the Gladiator 
class using the animation notifpcations. However, this step needs preparation prst! 


So let's open any of the attacking animations either by choosing the animations 
section from the upper-right corner of the animation blueprint, or by double-clicking 
the animation itself from the content browser. 
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By dragging the timeline, you can jump to any frame of the animation. | wouldn't 
suggest going to the end of the animation, as lots of animations contain afew extra 
frames at the end, but! would say go to the moment where the character actually 
bnishes the attack, and you can right-click on that, on the timeline, and choose Add 
Notify; this will allow you to enter a name for a notibcation. 


A notipcation is simply a call for a function at a given moment; this means that you 
can call functions at certain moments in animations, which is great. You can do lots 
of awesome things using this feature; for example you can spawn some particles or 
play asound effect every time the character's foot hits the ground! 


Anyway, | managed to name my notipcation On At t ackEnd. Remember the name 
you use, and apply it for all the attack animations you have. Remember, once you 
create a notipcation, you can reuse it for all the other animations under the same 
animation blueprint, which means that, tf you have another attack animation for the 
same character, you can directly add the same notipcation and you don't haveto a 
create new one. 


iirdPerson Attacks 





Once you are done adding the notipcations you want for any attack animations, or 
any other animations you have, you can go back again to the logic section of the 
animation blueprint and there you can þnd the newly added method listed within 
the event of the right-click menu. 
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Add that event and, simply use it to call theOnPost At tack method from the gladiator 
class of the character controller that is using this animation blueprint instance. 


€ AnimNotify_OnAttackEnd C >> Cast To Gladiator 


. «CD è 
Object Cast Failed D 
F Try Get Pawn Owner As Gladiator EE 
Target [self] Return Value > D 


Target 





Now, the last step in completing the animation blueprint is to add the animation 
state machines themselves. From the main graph of the animations, you can add a 
main animation state machine and name it anything you want. This one will be the 
main one, usually we call it Default. Connect it to the pnal animation pose. 


That means, whatever happens inside this Default state machine will be used as the 
bnal pose for the character animation blueprint at the current frame. 


DefaultSM Final Animation Pose 


a 

i eee aoe eee Tae ne Va So 
ġ Result 

A 


? 





When you double-click on the Default state machine it will take you inside it, which 
is empty. All that you have to do is add states, name them, and give them conditions. 


You can create states from the right-click menu and you can connect them by just 
dragging and dropping lines out of them, just like blueprint nodes. 


| managed to added several statuses, such as: 


Å IdleToRun: This displays the animation of the blendspace we made, to blend 
between idle, walk, and run 


Å Jump Start: This plays the start of the jump animation, and it is not loopable 


[64] 


Chapter 2 
Jump Loop: This is a loop for the middle part of the jump animation, and it 
has to run and loop as long as the character Is in the air 


Jump End: Once the character gets on the ground, the end of the jump 
animation should play once 


Die: If the player is dead, we play the death animation 


Joo > D> D> 


Attack: You can add as many attack states as you wish to fit the amount 
of attack animations you have, but make sure that the amount matches 
the maximum value of theat tack! ndex 


JumpLoop 
JumpStart 


Perra PEE ETEA A 





PA 
JumpEnd Attack1 
= 
~ S 


It might look complex, but state machines are one of the most fun and easy topics in 
animation programming as it takes the load from the code side, and makes it more 
visual and easy to digest. 


Once you drag a line out of a state to another state, you will have a little circle with 
a double directional arrow; this is called the condition. If you double-click it, it will 
take you to a graph where you can put some logic: this logic will be the condition 
that will trigger the transition between the two states. 
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If we take the transition between Idle and Die, it will simply be the value of the 
Boolean calledisStil! Alive; double-click the condition circle between both 
states to see it. 


Result 


Can Enter Transition 


Is Still Alive 





Build any logic you want. It does not have to be one condition, you can add as many 
as you wish. Moreover, you don't have to double-click to open the graph every time 
you want to check the condition; you can simply hover with the mouse over the 
condition circle, and it will display a conclusion of the logic for you, if there is any 
logic inside It. 


IdleToRun to Die 


Transition Rule (in words) 


Documentation 
hold (Ctrl + Alt) for more 
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However, regarding the state itself, if you double-click it you will fond that you can 
attach an animation or another state machine and you can keep branching state 
machines as much as you wish. I'm sure you wouldn't do this, as there are tons of 
ways to achieve any result, simply. 


By opening any of the states, let's say the Die one, you may pnd it has only a Play 
animation node; you can simply put it on the right-click menu. 


Final Animation Pose 


a 
a 


5 Result 
á 
: - Se eee SP 
Play ThirdPerson_Dead 


The most important part here is the settings section that is activated when you 
select the play animation node, as it gives you two main (and important options, 
among others): 





Å Sequence: From this drop-down menu you can select which animation 
should be played. 


Å Loop Animation: This defines the type of animation. Because sometimes you 
can blend between animations when it is done, if the animation is looped it 
will never be done and that means no blend is going to happen. So it is very 
important that, once you add a play animation node, you decide carefully if 
it is going to loop or not. 


4 Settings 
i: pin) Sequence ThirdPerson_Dead 


i+: pin) Loop Animation 


i+: pin) Play Rate 


Node 


> Sync Group 
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Building the blueprint 


Now with everything done on the animation blueprint side, itis a very simple step 
to get it all together. First, hit Save on the animation blueprint and close it; we don't 


need it again. 


You can now right-click inside the content browser, and choose to create a blueprint. 
This will open the classes list to choose a base class for this blueprint. The ones on 
the top are the most popular ones, but we want to create one based on our Gladiator 
C++class we madeat the beginning of this chapter. So, you can look at the bottom 
section and type the class name in the search box and you will pnd it. Use it and 
create the blueprint. Give it aname and remember this name, as we are going to use 
it in the þnal step of this chapter in order to use it as the default pawn. 


AL Pick Parent Class 


4 Common Classes 


Qator ooo o An Actor is an object that can be placed or spawned in the 
world. 


A Pawn is an actor that can be ‘possessed’ and receieve 
input from a controller. 


sic tee is a type of Pawn that includes the ability to walk 
ee ieo responsible for controlling a 
Sere ut ete robe pe ni st 
caw is a reusable component that can be 


rete cont Garten ef T AN cena AER 
4 All Classes 
gladiator 
rT @ Objeci 
4@ 
43 
4§ 
f 





Once you have the blueprint, double-click on it in order to open it, and don't panic 
because It doesn't look like what you expect, or does not look like anormal blueprint 
based on an actor. 
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What you are seeing is called the default view and it is displayed usually for 
blueprints based on C++ classes. You can see a note telling you that, so you can 
hit the O pen Full Blueprint Editor button in this note in order to open the normal 
blueprint. 


SF Class Defaults 


NOTE: This is a data only blueprint, so only the default values are shown. It does not have any script or variables. If you want to add some, 





Don't be worried, the default view is still accessible but in a different way. Whilein 
the full blueprint editor, if you want the default of any of the components, you can 
just hit the D efaults button on the top bar and it will load the default for you in the 
right-hand panel. 


Now you can see, and locate all the components we have created at the constructor 
of the Gladiator class, such as: 

A CameraBoom: Sprint Arm Component 

Å FollowCamera: Camera Component 

Å EffectSprite: Paper2D Sprite Component 
You'll not only pnd these three components, even though those are the three 
components we've created through the C+ code, there will also be other 


components that are, always there, by default, within any blueprint based 
on acharacter class. 


Ë GladiatorCharacter(self) 


d CapsuleComponent (Inherited) 
mB, ArrowComponent (Inherited) 
+ Mesh (Inherited) 
4@, CameraBoom (Inherited) 
% FollowCGamera (Inherited) 
@ EffectSprite (Inherited) 


€s CharacterMovement (Inherited) 





N ow the last step in creating the player blueprint, is to assign some default values. 
As there are tons of default values for each of the components, you can go around 
them and tweak them to pt your needs. The most essential ones to give you a 
working character now are the assets. 
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Select the M esh component from the components list, and open its default values by 
clicking on the defaults button on the top bar. 


In the animations section you need to ask it to Use Animation Blueprint, and assign 
the animation blueprint we created earlier in this chapter. 


Then select the Skeletal M esh character you want to use from the free assets you 
have imported in to the project. 


4 Animation 
Animation Mode 
Anim Blueprint Generated Class or 
"F 


4 Mesh 


l SR Chan Raggedelite + 
Skeletal Mesh J +H 
T Ei 


Now, you þnally havea fully working characteré But wait a second, there is still one 
more thing to make it perfect. 





As you can see, the character mesh is not well aligned inside the capsule (the collision), 
so you probably need to select the mesh again and keep adjusting its rotation to face 
the correct direction of the capsule and adjust its vertical axis positioning, as itis yying 
on air now. A few tweaks, but it will make things a lot clearer. 


a Transform 


Location ~ x a oocm E 


Rotation ~ N on ed 270.0" 3 
Scale + S e ee 





Adding the blueprint to the GameMode 


Once everything isin place, all that we need now is to make sure that the Ga me Mo d e 
class for the game (or for this level) is going to load our Gladiator blueprint by 
default once the game starts. 
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Open the Visual Studio project again, go to the Be! | z Game Mode source ble, and add 
this piece of code inside its constructor, in order to set the Def aul t PawnCl ass by 
depning which blueprint is to be used by specifying its name and path within the 
project. 


Static ConstructorHel pers::FClassFinder <APawn> 
Pl ayerPawnBPClass(TEXT("/Game/ Bl ueprints/GladiatorCharacter")); 
if (PlayerPawnBPClass.Class != NULL) 
{ 
DefaultPawnClass = PlayerPawnBPCl ass. Class; 


} 


And now, If you start an empty level with the basic elements, or even one of the free 
asset levels, you'll have the Gladiator fully interactive inside the level. 
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Summary 


You went through the process of creating your prst HUGE steps. You not only saw 
how to build a C+ class inside Unreal, but also learned how to apply the C++ 
knowledge you have to Unreal's version of C+. 


You also learned some hints about the Unreal Engine C++ styling code, what M acros 
are, when to use them, and how to use access specibers within Unreal. 


You not only built your prstgamep! ay element, and the cornerstone of the game, 
but you also learned about the different components of the Unreal environment, 
such aSPaper2D sprites,Camera,SpringArm, and soon. You got yourself into 
alot of Unrealliology! 


Creating the C++ class is only half-way to using it. A class without an actor or 
blueprint in the scene is nothing. You have to learn how to build blueprints and 
actors based on your class, you have to learn how to communicate between C+ 
and its blueprint instance, and you have to learn how to modify your blueprints 
based on C++ you made real progress in mastering this. 


While you already Know how to depne inputs in project settings, this is useless 
without integrating those inputs inside the game; you have now learned in the 
course of this chapter how to map inputs by code, and convert them to real logic. 


You learned about taking a character mesh and animations, then how to use 

them together; how to build a fully playable character; how make an animation 
blueprint; and how to set its rules. You also gained lots of Knowledge about blending 
animations, making blend spaces, adding sockets for skeletons, and much more. 


Now, while you haveall this in mind, | would suggest you start a project from 
scratch and try to make almost the whole thing from scratch several times. That 
way you will be sure you are able to make it alone without turning back to the 
book. The prst time it will appear difpcult, so refer to the book again; later, 
however, you'll be a master it! 


Now let's take a rest, and forget about code for a second. The next chapter is all 
about levels and map design. 
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While we havea player made with a character controller, it is time to build what 
Should look like a level, where we can spawn our character and start running around. 


Building alevel should sound likea fun task, but in fact it isn't. It is more of an 
artistic task, where you have to Imagine, create, and build a level from nothing. 
You will be constructing your worlds, maps, and levels. Unreal tools make it easy, 
but still you need what should be called an artistic vision to build great worlds. 


By the end of this chapter, you'll learn about the following topics: 
Å The requirements of the level and the aspects of level designing that we care 
about in this game 
H ow to place assets into the map 
H ow to use different brush types to place different type of assets 
H ow to add lights and baking lightmaps of the level 
H ow to create water surfaces to make the level more visually appealing 
H ow to set a player start point 


> To Jo To To To 


How to add and display the navigation mesh for the level to make it ready 
for theAl 


With our targets depned, go ahead and spend sometime thinking about the map you 
want to create, how you want it to look, and how long you want the player to spend 
while playing it. Once you pnish this little brain-storming session with yourself, 
come back to this page again! 
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The art of level design 


While this is not a level design book, I've to say that designing a level and design in 
general is not about tools, techniques, and technology. In fact, it has nothing to do at 
all with techniques or engines. It is an artistic and creative thing. 


But there are always major points that you have to keep in mind while designing 
a level; these points depend on the game itself, its genre, its story, and lots of other 
factors. But for Bellz, I've found the following points come in handy to the game: 


Å Thelevel has to tell a story: | need the player to tell the story of the level 
through it. | don't want to show the player a movie describing what 
happened here before he came to the level, and | don't want to display 
text to tell what happened at this place. But! want my level itself, and the 
positioning and selection of assets, to tell the story of the place on its own. 


Å Thelevel needs to look eye-catching: Having a fantastic game is not only a 
result of using good and polished assets, but also of the way the assets are 
placed and used. | need my level to use top high-end quality. | need to put 
asky dome, moving skies, sun light, and water that moves. | need to add 
anything that makes it look amazingly real. 


Å Thelevel has to be efficient: This means that | need to use the fewest possible 
resources as possible. We are talking here about a top-quality game; we can't 
add things forever. We have to be worried about the performance, the size, 
and the quality. The level has to be modular and bidirectional. It has to be 
modular when it uses fewer assets, but in a different way; the same assets 
should create different things. It has to be bidirectional when | do force the 
player to move all over the place several times. 


Those are the factors | care about for this game, but the art of level design has lots 
and lots of tricks and todos. If you are interested recommend you start with the 
following article at Wikipedia, where you can learn more skills about the level design 
process and get an overall idea:https://en. wikipedia. org/wiki/Level design. 


| would suggest you spend some moretime, if you are interested, and read these 
episodic articles on Gamasutra. comall about level design, at:http:// www. gamasutra. 
com bl ogs/ DanTayl or/20130929/196791/Ten Principles _ of Good Level | 
Design Part 1. php. 
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As we have already imported the needed assets from the launcher in Chapter 1, 
Preparing for a Big Project, you can now start placing the assets to build the map 
you have imagined. 


Placing assets into the world 


Now is thetimeto actually start visualizing the world and make It real through 
the process of asset placement. This is an artistic steo, where you have to use your 
imagination in order to place the assets. The process of placement itself is just a 
matter of dragging and dropping items from the content browser into the map, 
just as expected! 


As we have mentioned earlier, level design has to be modular, which means that 
we use as few pieces as possible in order to construct the pnal level, but we combine 
these together in different ways in order to give differently composed items. 


If you have imported the assets package from the Unreal launcher, as we discussed 
during Chapter 1, Preparing for a Big Project, you'll end up having this set of modular 
assets ready to be used in the map designing process. 
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When I say "composing the modular assets together to build different pieces", | mean 
that we can take the column asset, for example, and just place it in the world to look 
like this: 





On the other hand, | can add another decorative asset to it in order to give it more 
effect, such as adding damaged ground bricks, to give the feeling and story that 
something happened near that, as follows: 
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Alternatively, | could even combine both together and add one more asset to givea 
good visual of the bridge, as follows: 





As you can see, with all three cases the asset has a different role, and it does not even 
look the way it should as an individual asset. 


Now, you know what you have to do. It is all about combining assets and positioning 
them. Go into the content browser and start dragging and dropping the items into the 
map. You may need to drop the same asset several times; you can simply copy and 
paste it with Ctrl +C, and so on, as you would do with a piece of text. 


| would suggest that you þrst make an outline on paper, when you havea chance 
to keep changing, erasing, and updating the design, which will make things faster 
for you in the editor, and perhaps will save you sometime while removing and 
adding loops. 


The point is that design is a more artistic area that depends on personal choice, 
where you can just imagine what you can do with the set of assets in hand, and 

you can keep trying. Keep what you like; if you dislike something, simply remove it. 
It is a process of dragging and dropping items into the map; apart from these, you 
can just position, rotate, and scale assets to give the feel you want. 
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Using brushes to enhance level design 


Your world is not yet ready for players or enemies, as all those meshes you've used 
mostly have no collisions. This means that the player will fall from the ground and 
can go through walls. 


When you import assets, you have the choice to build colliders for then—colliders 
that almost pt the shape of an asset. But this is costly when you do it for tons of 
assets. From alevel design perspective, designers prefer to put the assets and then 
collisions as a layer of geometrical shapes while laying out the level. 


Unreal Engine has a variety of range of meshes and shapes that could be used for 
different purposes. One of the most interesting shape types is brushes, called BSP. 
These shapes are not only placeable, but are also modipable at the vertex and face 
level, which means that you can use several cubes to build a complex shape. The 
currently supported brush shapes are the following ones, which can be accessed 
from the BSP section of the M odes panel. 


Recently Placed Rix 


Basic 
; Cone 
Lights 


visual Effects Cylinder 


BSP 
Curved Stair 
Volumes 


All Classes e Linear Stair 
Spiral Stair 


Sphere 





Now, the goal is simple! While those brush shapes could be invisible, we will 
be throwing lots of them around the map, and making them invisible and not 
renderable. At the same time, we will be enabling collision for them. This way, 
the brushes we use will be behaving as invisible walls. 
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Using this method will guarantee that, regardless of the amount of collision 
surfaces we have in the level or in the game in general, they will be basic shapes 
at the end of the day: no hulls, no convex shapes, no mesh colliders that are costly 
in large numbers. 


In order to convert any brush shape you create into a blocking surface, you have to 
run through the following two important steps: 


1. After creating the shape itself, you will need to convert its actor to a blocking 
surface by setting the value Convert Actor of the Actor settings from the 
D etails panel to Blocking Volume. 


Actor 
1] selected in Persistent Level 


Convert Actor Convert Actor € 


Can be Damaged 
z sree . AudioVolume 
Spawn Collision Handling Meth 
» BlockingVolume 
Initial Life Span Came a 
a An invisible volume used to block other actors. 
{ pr 2 CullB ald (tc + Alti f ay 
Find Camera Component when = REECE | UAE Fon (ots 
ESR HOC al wei wwe 


È KillZVolume 
Ignores Origin Shifting ry LevelStreamingVolume 


> Pivot Offset 


Enable Auto LODGeneration ®: LightmassCharacterindirectDetailVolume 
l! LightmassimportanceVolume 
NavMeshBoundsVolume 


Tags 





2. Converting to a blocking volume will add few more settings to the brush 
in the Details panel. All you have to do now is set Collision Presets 
to something that pts your need. | found Invisible Wall or Block All 
Dynamics; both choices will get the job done. 


4 Collision 
Simulation Generates Hit Ever m 


Phys Material Override None 


Generate Overlap Events 


> Collision Presets InvisibleWall ¥ 
Can Character Step Up On ECR Yes ¥ 


¥ 
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Adding lights to the level 


Now we havea map that is well made and well designed; it has all we need to serve 
our story, and it also has collisions and layouts to give the player a good and realistic 
experience. 


Talking about realistic experience, our level still isn't lit, which means that it is not 
going to be visually appealing or even realistic (if the game has to be realistic). This 
means that we need to add some sort of lighting to the map in order to make it clear 
and vivid! 


The process of lighting a map is an artistic process in its core, where you have to 
decide where to put the lights, the color for each light, and even the type of light, 
and the angle for its rotation. All these factors affect the pnal result and that will 
in turn affect the player's experience. But while it seems so artistic, it is also a very 
technical topic, as you have to be aware of light types, shapes, and performance in 
order to guarantee a smooth experience. 


In case you have no experience with lighting within Unreal Engine, | highly 
recommend you to read one of my previous Unreal books, U nreal Engine Lighting 
and Rendering Essentials (https://www. packt pub. com/ game- devel opment/unreal - 
engine-lighting-and-rendering-essentials).Itis all about mastering lighting 
and rendering within Unreal. 


For such a level, or in general for most of my games, | do count on lightmaps, which 
we will discuss next, in order to get the best quality and the best performance. But 
also, building the lightmaps itself requires us to add some lights throughout the 
earlier level. 


Now, you probably havea map that looks different from the one! have, so the 
number of light sources or even the light settings might be different. But in my 
case, | needed to put the following: 


Å Directional Light: Directional Light is essential for any outdoor scene and, 
perhaps, for some indoor scenes, as it is simulates sunlight (infinite rays in 
one direction), which means that it is probably essential for the map you've 
created too. The most interesting part of Directional Light is that rotating it 
will give you a different timing of the sun and it has the ability to create light 
Shafts! You can find the Directional Light source inside the Lights section of 
the M odes panel. Adding it to the map is a matter of drag and drop. Then, 
you can change the color and light settings that will make your level look 
the way you want it to. 
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Sir Modes 


Recently Placed 
Basic 
Lights Point Light 
Visual Effects oat 

' Spot Light 
BSP 
Volumes Sf, Sky Light 


All Classes 





Å Point Light: Point Light is less important than Directional Light, and you 
might make an entire game without the need to use one! Point Light, as its 
name implies, emits light from a point in all the directions in a spherical 
Shape; the emitted light is not infinite, unlike Directional Light, which means 
the light rays decay after a specific distance that you can define. | put a few 
point lights in my map to enhance the visual; it well good for fire and such 
light sources that light specific distances. Point lights are accessible from the 
Lights section of the M odes panel, and are placed by dragging and dropping 
them into the level. 


“ie Modes 


Recently Placed ce: Directional Light 
Basic 

Lights 

Visual Effects 


BSP 


Ca o 
Volumes ee) Sky Light 


All Classes 
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Put in some point lights if your map requires them; they don't have that 
much effect on performance, but they do have a huge effect on the visual, 
especially if they have a variation of different colors rather than the main 
sky/ directional light color. 


Å Lightmass Importance V olume: Lightmass Importance V olume is one 
of the volume types that you can find inside the M odes panel under the 
Volumes section. 


i Modes 


‘ » N 
K d C A v E, 
SearchClasses Or C“(;‘CSCO(CSON 
Recently Placed 


> 
Audio Volume 


Basic 


° 
Lights W, Blocking Volume 


Visual Effects l 
Camera Blocking Volume 


BSP 
Volumes Cull Distance Volume 
All Classes 
Hierarchical LODVolume 
Kill ZVolume 
Level Streaming Volume 


j- Lightmass Character Indirect Detail Volume 


Maninass Importance 





Also, you can create one from scratch in a shape that pts your needs. If you have 
just created a brush, as we mentioned earlier, you can convert it into a Lightmass 
Importance V olume rather than into Blocking Volume. 
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4 Actor 
1 selected in Persistent Level 
Convert Actor 


Can be Damaged Search p 


z beara rere g AudioVolume 
spawn Collision Handling Meth 


wy BlockingVolume 


Initial Life Span A : . ; 
Se ta CameraBlockingVolume 
API E : © CullDistanceVolume 
Find Camera Component when - i ; 
ey HierarchicalLODVolume 
> Pivot Offset ae 
P KillZVolume 
ignores Origin Shifting 2 LevelStreamingVolume 
Enable Auto LODGeneration $: LightmassCharacterindirectDetailVolume 


Tags “T LightmassimportanceVolume 


- NavMeshBoundsVolume 





Lightmass Importance V olume is very essential as long as you are using lightmaps 
and as long as you havea huge level. Sometimes, there are a lot of meshes and details 
out of the player's reach, for example, far away mountains, and you are sure that the 
player will not be reaching it. In cases like these, you need to somehow exclude those 
items from the process of building the lightmaps. 


Building lightmaps is a matter of throwing photons around the level while having 
lots of faraway meshes. This means throwing more and more photons and, at the 
same time, taking even more time while building the lightmap itself this is even 
worse at the end, when you get huge lightmap ples! 


So, if your levels have some parts that are not required to be lit, | would recommend 
you put in aLightmass Importance Volume and scale it to bt the playable and 
reachable area of the level. In my case, the following is how it looks when it just 
includes the playable section of the map. 
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Now with all that in the level, | bet you havea very vivid and visually appealing 
level, with everything lit and looking as nice as it should. But, as we are making 

a game that needs to run almost 60 frames per second, we have to worry about 
the performance, not only on the development machine, but also on the weakest 
computer a player might have. This means that we have to start baking and saving 
some lightmaps, which we will do next. 


Building lightmaps for a level 


Lightmap is a term used for a lighting concept, where all the light data is saved in 
maps and the lights themselves are disabled at runtime. This means that there will 
not be a real-time lighting for those baked objects. This is widely used in games in 
order to reserve GPU calculations for something else. 


The process of building alightmap (lightmass) itself is not complex; it is just a case 
of hitting the Build button. But what takes some time is the tweaking done before 
the button is pressed. 


The rule of lightmaps is that only static objects can be baked into lightmaps, which 
means any movable item at the level will not be written to lightmaps, and that 
includes, but is not limited to, characters and enemies. This means that you have 
to make sure that the M obility setting inside the D etails panel for all the items 
that are not meant to move in your scene is set to Static. 


4 Transform 
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That takes us half-way to lightmaps. The other important setting is the resolution 

of the lightmap of an object. AS we mentioned, lightmaps are like images with light 
values, which means that they have a resolution. The lower the resolution, the less 
detail and quality you will get, but with faster building time and VRAM resources 
usage. The higher the resolution, the better quality and detail you will get, but with 
more building time and a higher risk of texture streaming crashes with some players. 
Therefore, you have to balance its value and deþne what matters and will be seen 
closely by the players and what Is out of reach. 


Each object has a Lighting section in the D etails panel, where you can set some 
values for light-related settings and tweak them. 
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a Lighting 


> Lightmass Settings 


Cast Shadow 





Once everything is OK and you are good with the chosen values for your static 
meshes, just hit the Build button from the top bar and this will build everything 
(including the navigations, if any). For faster results, you can hold this button to 
choose one of the suboptions, which is basically Build Lighting Only. 


‘| = i F "F k = "w 


Build Compile Play 
: Lighting 


Lighting Quality 


Lighting Info 
C Use Error Coloring 


‘|_| Show Lighting Stats 





Now, the level looks even prettier and its performance and rending cycles are faster. 
It is time now to add one more detail to the level, which is water. As the water will 
look live and moving, it will not need to be included into the lightmaps, so let's add 
it now. 


Creating water surfaces 


When it comes to creating an entire game from scratch, you have to be productive 
and smart about consuming time and resources. Sometimes, you have to rely on 
things that are already made with Unreal. For example, we could build this game 
based on a Third Person Game template. This might have saved us the time we 
spent creating the player controller, but we managed to create it from scratch in 
order to build it in a way that bts our needs. 


But there are other things that were made by the Epic team for us in order to make 
life easier and faster, just like the popular Ocean shader that was made and shared 
during Unreal's live streams. 


We could spend lots of time trying to create this shader from scratch, but eventually 
we will end up with something not very close to it. This shader can be found with 
many Unreal free examples in the Learning section of the launcher, and it is free to 
use for all types of projects; it is really used in a wide range of games. 
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Fortunately, this shader is one of the Inpnity Blade assets we have imported into our 
game in Chapter 1, Preparing for o Big Project. This means we already have the shader 
material within the project. You can easily pnd it by typing its nameM. PI ai ns_ 
Ocean atthe content browser search tab. 


© Content » InfinityBladeGrassLands » Environments + Plains » Env_Plains_Organic + Materials + 


AOS cach Materials 


Cliff M_Plains_Ground M_Plains_Large E 


re n M_Plains_Small 
Brick Rock een | 


T aca Wihitao 7, Nains 
Mubase White M_Plains. Bock 





Once you pnd it, | would highly recommend spending some time understanding 
it, just in case you want to add more details or even changes in order to adapt the 
visuals of your map. 


N ow, let's come back to creating the water surface. Creating a water surfaceis a 
matter of creating surfaces that hold the Ocean shader, which means that you can 
create a plan mesh or cube, and apply this shader to it. Or you can even createa 
custom mesh in Maya or 3dsM ax and export it to Unreal. It doesn't matter what 
type of mesh, but eventually, you have to create a mesh with a sizable number of 
vertices and just drag and drop the Ocean shader on it. 


In my case, | used a plain mesh, scaled it to bt the level boundaries and even alittle 
more, and then applied the Ocean shader to it. 
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Player Start 


Your level is still not playable yet or, to put it another way, in another meaning, hitting 
Play might not make any difference. This means that we need to add something to 
allow us to spawn the player and start using the controller we have created in Chapter 
2, Seating Up Y our Warrior. In order to be able to spawn a player at any given position, 
we need to either drag and drop the player Gladiator Actor blueprint into the start 
point or use the Player Start actor and position it at the start point. 


qir Mades 


qe! f AS Y 9) 


Recently Placed + Empty Actor 


Basic 


Lights M Em pty Character 


Visual Effects ENS 
Point Light 
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Volumes \ Flavell 


All Classes 
z Cube 





The Player Start actor can be found in the Basic section of the M odes panel, and as 
with anything else found within the M odes panel, you can use it by simply dragging 
it into the level. The Player Start actor has no settings to be changed other than its 
position, which will be the position for soawning the player. But still, it has all the 
default setting you can pnd within any other actor type, such as a tag or rendering 
state, which will not affect its function. 
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N ow, drag and drop the Player Start actor at the position where you want the player 
to start the level. 





While Player Start seems like a very basic and simple actor, but it is really one of the 

most complex things within Unreal, as it gets its complexity from its rules. To be able 
to work perfectly, you have to know what rules the Player Start actor has. The Player 
Start set of rules that | found after a few experiments with Unreal is: 


Å You can haveno Player Start in your level, but once the game starts that 
will make your player fall from the sky at the latest known camera position 
during edit mode. 


Å Having a player controller (the one defined in Game M ode as the default 
Pawn Class) inside the level is enough to make its position as the player start. 
This means that the engine will ignore the player's start position, and will start 
from where you dropped your player controller during the edit mode. 


Å You can have more than one player start actor inside the level, but once you 
hit start, the engine will use the most recent one as the actual player start. 
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Å You can't place the player start in a wrong position, for example, half-way 
inside the ground. Unreal will report that as a bad position by tagging 
its gizmo with Bad Size icon, but will not fix it for you most of the time. 
Sometimes, the engine will fix the character spawn position at runtime, 
while it doesn't at other times. So, you have to be sure that your player 
start is not titled the BAD size! 





The navigation mesh 


We havea complete level that looks perfect. The player is autospawned at runtime 
and we can run through it. But still there are a few more things that are needed for 
the level that aren't level design-wise, but it are needed for the game logic itself. 
One of those missing parts is the navigation mesh. 


If you don't know what the navigation mesh is, itis the path pnding implementation 
that is used within Unreal Engine in order to pnd a point via another point. 
Alternatively, in another meaning, it is used to let an enemy pnd what he Is seeking 
for. With that said, it means even if we have enemies, they will not be able to navigate 
through the world until thereis a valid navigation mesh. 
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Adding a navigation mesh in Unreal Engine is a very simple task. It lets you focus 
more on creating and pitching your enemies and their behaviors while navigating 
with one step. 
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By dragging and dropping Nav Mesh Bounds Volume from the Volumes section of 
the M odes panel, you have already placed a navigation volume that Is responsible 
for creating the navigation mesh. 


By default, this volume will look like a cube volume. You can scale it to pt all the 
level or you can create several ones; itis up to you. However, the rule is that the 
walkable area at your level must be covered with the navigation volume, regardless 
of the several volumes or only one volume. | managed to use only one volume to 
cover all the walkable areas, and increased its scale to bt my level. 
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Now, if you want to see your navigation mesh itself, just press P on your keyboard 
and you'll see all the walkable areas colored in green. It will automatically update 
any time you move stuff and assets around your level. 





Summary 


Now, you have something you can show to your friends as a game. While itis nota 
complete game, you have a great character controller that was made from the ground 
up and an awesome level, where the player can navigate and your friends can test 
what you have achieved so far. But still, what do you have to show for it? 


Well, you have learned some tips about level design, which probably gave you the 
chance to make a better design than what you had in mind, and you learned how to 
place assets to construct a level. You also learned how to put the player within the 
level to start navigating through it. We also learned all the rules, tips, and tricks of 
the Player Start actors, and how to use them in different ways. 


If we talk about how polished your level is looking, well, simply and easily you have 
added water surface that made the level look gorgeous. 


Adding the navigation mesh was a tricky step that will make our process faster later. 
You learned how to add navigation volumes, how to display the navigation mesh, 
and the rules to follow while adding navigation volumes. 
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Adding light to the level will allow you to control its mode and day time. You learned 
how to add light to your level, and how to implement settings for it in order to bake 
the light to make the game performance better at runtime. With all you have learned, 
I'm sure you ended up with a nice playground for your character. 


While we now have the character and the playground, let's go ahead directly and 
create some enemies in the next chapter. 
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Usually, when we speak about creating a game, we all just think about enemies, 
evils, and the bad guys. Of course, games are beyond that. But enemies are what 
usually make a game what it is; enemies and Al are a huge part of the fun. Enemies 
are what usually give you a goal to pnish a level, to use a weapon, or even to take 
a mission. 


Apart from this, on the other side of the game, involving us, the developers, we all 
are more interested more in Al as the most important part of the game development 
process. It is not only the graphic quality and performance that make a game more 
special than the previous one, but also topics such as Al and how smart and lively 
your Al Is. 


When it comes to creating Al for your game, Unreal Engine comes with amazing 
content. Have you ever liked games such as M ass Effect, God of War, and The Batman 
Arkham series? All these games have been made with Unreal Engine (Unreal Engine 
3 most of the time), and all of them havea remarkable Al and boss pghts that we 
cannot forget even after 100 years! 


The thing with Unreal Engine is not the games that have been made with it, but the 
number of tools and subtools that are supported by the engine, which allow you 

to tune and detail your enemies and Al behaviors. They are useful for even the 
smallest tasks. 


That's the topic of this chapter: understanding the tools, asset types, and how to code 
in C++all within the Unreal Engine ecosystem in order to add Al to our game. 


By the end of this chapter, you'll be able to: 


Å Build anenemy class and write down all the required gameplay code 


Å Build logic to detect the player based on the navigation mesh we built earlier 
using Nav Mesh Bounds Volume 
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Å Useawiderangeof Al-rdated assets, such as Tasks, Services, Blackboards, 
and Behavior Trees 


Å Usethe behavior tree editor to build the needed behaviors for AI 
Å Add various triggers playing different roles 


Å Enhance the code that the animation notifies in order to call a function ata 
precise moment 


Å Practice creating animation blueprints and retargeting 


Let's get started! 


The overall idea 


When it comes to building enemies, or Al in general, you have to understand the 
whole game, its concept, and the game design, probably through the Game Design 
Document (G DD ). Knowing these aspects earlier will make the job easier for you 
and your team, and for the plan that you'll come up with in order to construct a 
whole AI system. 


In general, there is onething that has always been almost the industry standard: 
basing everything in inheritance classes. This really makes sense, as all enemies, 
regardless of their types or behaviors, have to share something at the end of the day. 
It's where you have to create a base Al class and inherit all the enemies from it. Or 

it might be more detailed; if the enemies themselves are from different classes, let's 
say animals, humans, and mechanicals, then you need a class for each, inherited 
from the base class, and then the enemies themselves will be inherited from this 
brst inheritance. Something like this: 


Vehicles Bipedal 
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It doesn't have to be exactly the same, but this is one way to do such an example: 
you can, for example, directly split the left-hand side into Humanoid and Animal, 
without inheriting them from Creatures, which is inherited from the base. It is just 
down to you, your game, and your design. 


While Bellz has a very small design goal (it shouldn't be a massive game, just a one- 
level game) and the assets and animations that | was able to get was for one enemy, | 
managed to create the whole AI within one class; | named itEne my . But in the event 
you are planning to create several enemy types and classes, | would recommend you 
use the basic C++ inheritance; it works just the same here with Unreal. 


The other part | want to mention is that having an Al system within Unreal is not 
just a matter of coding several C++ bles full of logic. Other things need to be done in 
a different way; for example, in order to control the animations we would need an 
animation blueprint, just like the character controller we made in Chapter 2, Setting 
Up Your Warrior, theGl adi at or class. Or in order to give the enemies the appearance 
of a mind, we need to build a behavior tree that is full of decisions to take and make. 
But to get a behavior tree, we need to create tasks and services, which are basically 
behaviors themselves. And that's how weare going to build our enemy sample: 

piece by piece, as all of those things are required. 


The Al assets 


As we discussed earlier in this chapter, the process of creating Al within Unreal 
Engine requires a recipe of several assets. Each of these assets is there for a different 
reason, and it does its own unique job. These assets are: 

Å Behavior Tree 

Å BTTask 

Å BTService 

Å Blackboard 


Let's look at these assets individually. 


Behavior Tree 


The Behavior Tree asset could be considered as a different type of blueprint, but 
it does not hold too much logic or coding; it holds several connections between 
different tasks, better described as behaviors. 


A behavior tree could be very complex or simple; it deoends on your Al system and 
the goals you have for it. 
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The best part about behavior trees is that they have their own editor with a unique 
visual aspect and not many types of nodes to use. Although the node types are few, 
they are enough to bring your AlI to life. 


Creating a behavior tree could be done by right-clicking inside the content browser 
and then pnding it underneath the Ariibaal Intelligence section. 


In my case, I've created one and called it Enemy BT. 
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While the behavior tree has several types of nodes or commands that you can use, 
there are always two main things you'll be using; they are not considered as assets, 
but you can think about them as functionalities for the Behavior Tree asset. They 
are as follows: 


A Composites: The composite node's main job is to select which task (branch of 
the tree) should be executed. All composites have numbers inside circles and 
these numbers represent the order the behavior tree will be following. 


A Decorators: A decorator is just like Service or Task; it is something that you 
can add to a composite in order to enpower its functionality. For example, 
you can use a decorator of the Blackboard type, in order to get a value from 
the Blackboard asset, to be used a specific tree branch. 


BI Task 


As the name implies, this type of blueprint represents a task that the Al will be 
doing. And whileit is a blueprint, you'll be able to put the logic inside it as you 
do with anormal blueprint. 


Also, you can write the logic in C++for it, and then call it through the blueprint. 
Regardless of the way you will be using it, a node within the behavior tree will 
represent the whole thing itself. 
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Personally, | prefer globally to code these tasks with a blueprint as long as they don't 
have too much logic; other times, | like to get a mix of both, blueprints and C++ code. 


In order to create a task, you need to go through the default process of creating 
anormal blueprint. Then, you need to base it on a class named BTTask_ 
Bl ueprintBase. 


Asmy Al sample will need only one task, | have created one asset of that type and 
named itEnemyAttackTask. 


AL Pick Parent Class 


a Common Classes 


| Q Actor An Actor is an object that can be placed or spawned in the 
world. 
2 Pawn A Pawn is an actor that can be ‘possessed’ and receieve 
= input from a controller. 
Paces A character is a type of Pawn that includes the ability to walk 
AB ina around. 


å Player Controller is an actor responsible for controlling a 
Pawn used by the player. 


| Game Mode defines the game being played, its rules, scoring, 
i Game Mole and other facets of the game type. 


>, Player Controller 


An ActorComponent is a reusable component that can be 
i Actor Component 
bai pone added to any actor. 


A Scene Component is a component that has a scene 


i scene Component | 
Best pon transform and can be attached to other scene components. 


4 All Classes 
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BTService 


The service works just like a task, but the difference Is that it is going to be called all 
the time. Even the way it is called from within the behavior tree is still the same. 


You can add the BT Service asset as you are adding a new blueprint, just like the task. 
But this time, you will be basing it on the class named BT Service_BlueprintBase. 
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| have created only one service, as my example Al will need only one, and | called it 
EnemySearchService. 


alt Pick Parent Class 


a Common Classes 
An Actor is an object that can be placed or spawned in the 
world. 
A Pawn isan actor that can be ‘possessed’ and receieve 
input from a controller. 


A character is a type of Pawn that includes the ability to walk 
around, 

A Player Controller is an actor responsible for controlling a 
Pawn used by the player. 


Game Mode defines the game being played, its rules, scoring, 
and other facets of the game type. 


An ActorComponent is a reusable component that can be 
added to any actor. 


A Scene Component is a component that has a scene 


scene Component 
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Blackboard 


Blackboard is very simple, but an important asset type. You can consider it as a data 
container, because that is simply its job. When you open the Blackboard asset, all 
that you need to do is add variables in the form of data. Later, you can use this data 
inside the tasks of the behavior trees. 


Creating itis very simple, as you can pnd it inside the right-click menu of the content 
browser under the Artibaal Intelligence section. 


oe 
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l've created one for my Al and named itEnemyBl ackboard. 
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Now, we have prepared our Al system. Nothing has happened yet. In fact, we don't 
have enemies yet, but we have set up the base structure of the system. Now, what 
we need Is to write some logic, but most importantly we need to prepare some 
animations that will allow us to code the enemy easily. 


The animation blueprint 


Any character or skeletal entity within your game, as long as it will be moving and 
executing animations, must have an animation blueprint to handle and manage the 
animation based on the set of the rules you depne. 


We have already discussed the process of retargeting the animations and preparing 
the assets in Chapter 1, Preparing for the Big Project. And we have discussed the process 
of creating and setting the rules for the animation blueprints in Chapter 2, Seting Up 

Y our Warrior. Also, we have discussed blend animation and how to blend different 
animations in Chapter 2, Setting U p Y our Warrior. | would suggest that you go ahead 
and build the animation blueprint and the animation setup for your character. 


| will show off the setup | made for my bears. Feel free to clone it or improvise as 
much as you wish based on your game design and the type of enemies you have and 
with the knowledge you have gained from Chapter 1, Preparing for the Big Project and 
Chapter 2, Setting U p Y our Warrior. | guess it is time for you to do the process for the 
enemies based on what you can remember. 
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Like anything ese with game logic, variables are the kings; functions and methods 
do everything (almost everything). But without variables, methods and functions 
are useless. So, let's add some essential variables in order to be able to proceed with 
the process. 


1. Themost important part is the variables. | have created a set of variables to 
control the animations and use them as conditions to control the animation 
states. The unique one is the integer called attackI ndex. This is basically a 
randomized value between 1 and 3 in order to get a random index. Based 
on this number, I'll display a random attack animation. 


4 Variables 


movementSpeed 


isAttacking 


isDead 





attackindex 


2. Theanimation graph contains only one state machine, the main one. | named 
itDef aul t and itistheonly one there. 


~ Final Animation Pose 
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3. Within the state machine, | have created several states. | blend between them 
based on several conditions. These conditions are the variables I've created 
earlier. And the values of these variable, as you will see later, are taken from 
the C++ code. 
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4. Theway aconnection and condition have been added is simple. By just 
dragging and dropping an arrow from a state machine to another, the 
connection will happen and a conditional little gizmo sphere will appear. 
By opening it, you'll be able to add any logic, similar to the blueprints logic, 
in order to act like a condition for that transition between statuses. As you 
can see, | have made three attack statuses, displaying them based on the 
attackI ndex random value. It is a good thing to keep some variations! 
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5. Then, | would like to split the animation blueprint logic into two parts. The 
brst part gives the velocity of the enemy, which will then be applied it to the 
movement Speed variable. This variable will be used to build a blend node 
between idle, walk, and run! 
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6. Thesecond part is a custom event that I've created. It is called 
G etA | BehaviorStatus. All that we need to do is fetch the value of the 
isAttacking andisDead variables from the C++ code that we made earlier. 
And pnally, it will set a random value for the attack index. So, each time the 
enemy attacks, it will display a different attack animation. 
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7. Thelast thing within the animation blueprints system | made is a blend 
space, just like the one we made in Chapter 2, Setting U p Your Warrior, in 
order to blend between idle, walk, and run. 
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Now, with all the animations in place and having created several assets for the Al 
(the Task, Service, Blackboard, and BT), it is time to write down the functionalities 
and make the BT itself. Let's go ahead with the C++ part, as the process of building 
the behavior tree will require a piece of the code. 


Building the C++ logic 


You are probably guessing that we are going to create an enemy class that will hold 
the logic for our enemy. As |I mentioned earlier, l'II not be inheriting several Al 
classes from each other, as! will have only one enemy. But, in fact, we are going to 
create two new classes for the project based on the base class of each. The new classes 
will be as follows: 


Å Enemy: This class will be based on theAChar acter class, which means that 
it will have alot of properties, such as our gladiator, asGl adi ator aS well 
is inherited fromCharacter. 


AL Add C+ Class 


Choose Parent Class 


This will add a C++ header and source code file to your game project. § Show All Classes 


O None 


An empty C++ class with a default constructor and destructor 


+ Pawn 


A Pawn is an actor that can be ‘possessed’ and receieve input from a controller 


@ Actor 


An Actor is an object that can be placed or spawned in the world 
@, Actor Component 
An ActorComponent is a reusable component that can be added to any actor. 
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Selected Class Character 
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Å EnemyAl Controller: This onewill be based on AAIController. While 
the ACharacter-based class takes its movement through Inputs, the 
AA|Controller-based class takes its movement through the environment, 
the navigation mesh, for example. 


Al Add C++ Class 


Choose Parent Class 


This will add a C++ header and source code file to your game project. Show All Classes 
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N ow, after adding both the classes and before we start doing anything within Visual 
Studio, you will pnd yourself able to differentiate between them via their icons. This 
is how both look in my project. 
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E a 


EnemyAl 
Controller 


Enemy 





Weare ready to start coding the logic for both the new classes in Visual Studio, but 
there is still one more step. Usually, anew project would not have all the needed 
modules loaded; we have mentioned this before. While we are working, we will 
need to add several modules. Take the Paper 2D module as an example; we added 
it during the process of building the player. 
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Now, weneed to add theAl module, as it is not loaded by default with any project. 
If you still remember, you can do it through the project Bui | d. CS ple, which is 
Bill z. Build. CS in the case of my project, and set it within the required modules: 


Publ icDependencyModul eNames. AddRange(newstring[] { "Core", 
“Corevopect™,. Engine", “InpütCore", “Al Modulers: "Paper2D"}); 


Now, we have everything set up and are ready to write the code. | would like to split 
it into two main parts: the part where we write theEnemyAl Controller andthe 
other part where wewritetheEnemy class. 


EnemyAlController 


| want the main job of this class to set the values for the Blackboard asset, adjust the 
rotation of the eneny, and use the navigation mesh. 


EnemyAlController.h 


Just like all the other header bles, we have to start with the includes. There is nothing 
fancy to include here, except the header ple of the base class: 


#include "Al Controller. h" 
#include "EnemyAl Controller. generated. h" 


Also, depne the class name, the inheritance, and the constructor. The three of them 
are made by default while creating the class, and probably, you don't have to change 
any of them: 


UCLASS() 
class BELLZ APIAEnemyAl Controller : publicAAI Controller 


{ 
GENERATED_BODY() 


public: 
AEnemyAl Controller(); 


As we discussed earlier, the Blackboard asset is like a data holder asset and 
theAl Controller will besetting its data; it is essential to create a blackboard 
component in order to use it as a reference for the required blackboard. 


In the same way, will be creating a behavior tree component. Later, inside the editor, 
we will assign the behavior tree we've created to it. 
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This way, we will make sure that any communications we need between the 
Al Controller and the assets we've created are going to be easy through this class. 


UPROPERTY( transient ) 
UBl ackboardComponent* Bl ackboardComp; 


UPROPERTY( transient) 
UBehaviorTreeComponent* Behavior Comp; 


As weare inheriting our class from theAAl Controller base class, there are several 
virtual functions that have their own functionalities and we need to override them 
here. We will be overriding thePossess function, which is responsible for treating 
this class as an Al, and theBegi nl nActi ve state. But keep in mind, the possess 
function works differently in the case of a multiplier game, as it is a server authority, 
which means that it is not called on the clients: 


virtual void Possess(classAPawn* InPawn) override: 


virtual void BegininactiveState() override; 


The next thing is to add a couple of functions. The prst one will be called Set Enemy. 
We will call it whenever we want to mark something as the enemy of our enemy, 
which means the player. 


| named the other function Get Enemy . As the name implies, this one will be called 
to return the current enemy of our enemy, which again should be the active player: 


UFUNCTION( BlueprintCallable, Category = Behavior) 
void SetEnemy(classAPawn* | nPawn) ; 


UFUNCTION( BlueprintCallable, Category 
class AGladiator* GetEnemy() const: 


Behavior) 


The last tree functions are mostly behavior-related, but not major behaviors, such 
as attack. These functions are more like the status of the Al. The þrst one is called 
UpdateControllerRot ation and is responsible for updating the rotation of the 
controller to the walking direction (usually forward). 


The second one is called PawnCanBeSeen. This oneis essential to detect the player or 
in other words, it is essential to tell whether the Al can see its enemy (the player) or 
can't see It. 


The last function | called isOnSearchFor Enemy. ASits name implies, its functionality 
will be searching: 


UFUNCTION( BlueprintCallable, Category = Behaviour) 
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void UpdateControlRotation(float DeltaTime, bool bUpdatePawn) : 


UFUNCTION(BlueprintCallable, Category = Behaviour) 
bool PawnCanBeSeen(APawn * target); 


UFUNCTION( BlueprintCallable, Category = Behaviour) 
void OnSearchForEnemy(); 


The last part of the header ble is meant to depne a few variables. These variables are 
there to get and store values in the blackboard: 


protected: 
int32 EnemyKeyl D; 
int32 EnemyPositionKeyl D; 


Now, you have understood everything related to the header ple. | made some 
functions to serve several goals while some virtual functions were being overridden. 
Finally, | made a few variables in order to control the blackboard and store the 
blackboard itself and the controlling behavior tree. So, let's go ahead with the 
implementation of the source ble for that class. 


EnemyAlController.cpp 


While this source ple starts with includes, | have to include a lots of stuff, mainly 
to handle the behavior tree and call anything related to it: 


#include "Bellz. h" 
#include "“EnemyAl Controller. h" 
#1 nclude "Enemy. h" 

#include "Gladiator. h" 
#include "BehaviorTree 
#include "BehaviorTree 
#include "BehaviorTree 
#include "BehaviorTree 


BehaviorTree. h" 
BehaviorTreeComponent. h" 
BlackboardComponent. h" 

Blackboard/ BlackboardKkeyType_ Object. h" 


es) Se S Sa 


Regarding the constructor, there wasn't too much to do except create the Blackboard 
component and the behavior tree, so | can assign them through the editor later and 
use their value within the coming set of functions: 


AEnemyAl Controller::AEnemyAl Controller(/*const class 
FPostConstructInitializeProperties& PCI P*/ ) 

|*: Super(PCIP)*/ 

{ 


|| create blackboard and behaviour components in the constructor 


[ 107 ] 


The Road to ThinkableAl 


BlackboardComp = CreateDefaultSubobj ect <UBI ackboardComponent >( TEXT( "BI 
ackBoardComp") ); 


BehaviorComp = CreateDefaultSubobj ect <UBehavi orTreeComponent >( TEXT( "Be 
haviorComp")); 


bWantsPlayerState = true; 
} 


Within thePosses virtual function, | decided to make sure þrst that the current 

Al Controller istheEnemy class type (l'Il be discussing theEnemy class in a 
moment). If it was true, I'll be initializing theB! ackboar d component, getting the 
value from its variables, and assigning them to the local variables I've made within 
this class (the protected variablesEnemyKey! D andEnemyPositi onKey! D). 


Last, but not least, | just started the behavior tree. It is necessary to do that, otherwise 
the behavior tree will remain ofyine, and the enemy will be stuck in his position: 


void AEnemyAl Controller::Possess(APawn* I nPawn) 
{ 


Super::Possess(InPawn) ; 
AEnemy* _tempEnemy = Cast <AEnemy>(!1nPawn) ; 


// start behavior 
if (_tempEnemy && _tempEnemy- >EnemyBehavi orTree) 


{ 


BlackboardComp- >I nitializeBlackboard(* tempEnemy- 
>EnemyBehaviorTree->BlackboardAsset) : 


|| Get the enemy blackboard ID, and store it to access that 
blackboard key later. 


EnemyKeyl|D = BlackboardComp- >Get Keyl D( "Enemy" ) : 
EnemyPositionKey|D = BlackboardComp- >Get Key! D("EnemyPosition"); 
BehaviorComp- >StartTree(* tempEnemy- >EnemyBehavi orTree) ; 


UE LOG(LogClass, Log, TEXT("===========>>>> Got the enemy and the 
BT have been started") ); 


} 
} 


TheSet Enemy function is very simple, as it is going to check whether there is already 
a Blackboard component and itis not null. Then, it will set the value of its Ene my 
class to the one being passed through the function parameters. Finally, it will set 

the value of the enemy's position. 
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Doing this means that the blackboard has the latest data, which means that, when the 
behavior tree wants to use the player data or its position as an enemy for our Al, it 
will pnd valid and up-to-date data: 


void AEnemyAl Controller::SetEnemy(class APawn* | nPawn) 
{ 
if (BlackboardComp) 


{ 
Bl ackboardComp- >Set Val ue<UBl ackboardKeyType Obj ect >( EnemyKey! D, 
| nPawn) : 
Bl ackboardComp- >SetValueAsVector(EnemyPositionKeylD, I nPawn- 
>GetActorLocation()); 
Set Focus(|lnPawn) ; 
} 
} 


Get Enemy iS even simpler than Set Enemy, as it will just get the enemy value from the 
blackboard. And as you can see, the function type ISAGI adi at or , which means that 
the enemy of the Al must be the player! 


class AGladiator* AEnemyAl Controller::GetEnemy() const 
{ 

if (BlackboardComp) 

{ 


return Cast <AGl adi ator>(BlackboardComp- 
>Get Val ue<UBl ackboardKkeyType Obj ect >( EnemyKey! D) ) : 


} 


return NULL: 
} 


While the Al is navigating through the level, it will look weird, as it is only changing 
its position to traverse between the points, but adding a rotation to it will make it 
more realistic and as natural as anything walking or navigating. It does not only 
change position, it also changes direction. 


| made a vector called TheCent er to store the center of the player. Then, | processed 
the whole logic if itis not0 and the player is valid. 


| used a simple math calculation to calculate the direction and store it in a vector 
called Di recti on. Then, | did the math clap to blend the rotation between the 
current value and TheNewRot ati on based on theDi rect i on Component detected: 


void AEnemyAl Controller::UpdateControl Rotation(floatDeltaTi me, 
bool bUpdat ePawn) 


{ 
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// Look toward focus 

FVector TheCenter = GetFocal Point(): 

if (!TheCenter.IsZero() && Get Pawn( ) ) 

{ 
FVector Direction = TheCenter - GetPawn()->GetActorLocation(): 
FRotator TheNewRotation = Direction. Rotation(): 


TheNewRotation. Yaw = FRotator::ClampAxis(TheNewRot ation. Yaw); 
Set Control Rotation(TheNewRot ati on) : 


APawn* const _tempPawn = Get Pawn(); 
if (_tempPawn &&bUpdat ePawn) 
{ 
_tempPawn- >FaceRotation(TheNewRotation, DeltaTi me); 


} 


} 
} 


Finally, by the end of the class, | did the search function, which is the longest yet in 
this class. 


The search function will check whether the AI is a valid pawn; if itis, it will proceed 
in the process; otherwise, it will just stop. 


Then, the use of af or loop and Get Pawnl terator allows meto get all the pawns 
within the world and go through all of them. 


Within thef or loop, | will test whether the index of the pawn is from the player class 
named AGI adi at or or just another enemy that is based on theAEnemy class. 


Then, if itis really not an enemy, | will do a þnal check to catch whether that player 
is Still alive or not using the method Get | sStill Alive webuiltin Chapter 2, Setting 
U p Your Warrior. If itis not dead, it means that | can set it as an enemy for the Al: 


void AEnemyAl Controller:: OnSearchForEnemy( ) 
{ 

APawn* _tempPawn = Get Pawn(); 

if ( tempPawn == NULL) 

{ 


return: 


} 


const FVector _tempLocation = tempPawn- >GetActorLocation(); 
float BestDistSq = MAX FLT; 
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AGladiator* PlayerPawn = NULL; 


//foreach all pawns in world 


for (FConstPawnlterator It = GetWorld()->GetPawnlterator(): It; 
++/ t) 


{ 
if (PawnCanBeSeen( *It) ) 


{ 
AGladiator* TestPawn = Cast <AGladiator>(*It): 


AEnemy* const _testEnemy = Cast <AEnemy>(Test Pawn) ; 


if (_ testEnemy) 


{ 
llit is just another enemy, not player 

} 

else 

{ 
if (TestPawn && Test Pawn- >Get! sStillAlive()) 
{ 


UE LOG(LogClass, Log, TEXT(" ===================>>>>> ENEMY 
SEEN %s "), *GetNameSafe(*Ilt)); 
const float distanceSq = (Test Pawn- >GetActorLocation() 
_tempLocation).SizeSquared(): 
if (_distanceSq < BestDistSq) 
{ 
BestDistSq = distancesq; 
PlayerPawn = Test Pawn; 
} 
} 
} 


if (Player Pawn) 
{ 
|| We saw someone, so set himas target. 
Set Enemy( Pl ayer Pawn) ; 
UE LOG(LogClass, Log, TEXT(" ===================>>>>> Set 
Target")); 


} 
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Now, we have completed the Al Controller; only one more note to go. You might pnd 
me using lots of UE_ L0G methods, but this is just to test and keep a nice log while 
playing just in case something went wrong. | can track it faster than throwing some 
break points. 


N ow, let's go ahead and break down the code for theEne my class itself. 


Enemy 


This class is very different, as it is not playing the controller role as the previous one. 
Here, we will be adding a component in order to build the enemy character itself, 
static mesh, triggers, and so on. 


This ts not just the building process for the enemy, but also the main and core 
functionalities, such as the attacking logic or what happens before and/ or after an 
attack takes place. 


Also, we include the attributes of the enemy, such as the attacking range, its health, 
or even the variables that will be controlling some animations, such as the status of 
life or dead. 


Enemy.h 


As usual, we will start with the set of the default header ples to be included and then 
the name of the class and its base: 


#pragma once 
#include "GameFramework/ Character. h" 
#include "Enemy. generated. h" 


UCLASS(:) 
class BELLZ API AEnemy : publicACharacter 


GENERATED BODY() 


Then, | managed to create three different components; all of them will be working as 
triggers. A huge one will be at the middle of the Al that will be taking the damage 
from the player. Alongside will be two other trigger spheres. Each will be parented 
to the palm of a hand and both will cause damage to the player when the AI attacks: 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Triggers, 
meta = (AllowPrivateAccess = "true")) 
classUSphereComponent* bodySpheretTrigger; 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Triggers, 
meta = (AllowPrivateAccess = "true")) 
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class USphereComponent* |eftHandTri gger; 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Triggers, 
meta = (AllowPrivateAccess = "true")) 
class USphereComponent* rightHandTrigger; 


Then, there is a set of default methods that is included in the code by default; this 
Includesconstructor,BeginPlay,Tick,andPl ayer! nputs. You are free to use any 
of them, but you can also ignore any or all of them as long as they are not serving 
any purpose for your logic: 


Pi The constructor 
AEnemy(); 


//Override the Postl nitial!zeComponents() 
virtual void PostIl nitializeComponents() override; 


|| Called when the game starts or when spawned 
virtual void BeginPlay() override: 


// Called every frame 
virtual void Tick( float DeltaSeconds ) override: 


// Called to bind functionality to input 
virtual void SetupPlayerlnputComponent(classUl nput Component * 
I nputComponent) override; 


| wanted to declare some variables to help me while writing the logic—Tot al Health 
to represent the health of the Al, At tackRange to depne the attack range of this Al, 
Att ackDamage to tell how much damage it causes the player when it attacks him, 
and a Boolean! s Dead to tell whether the AL is dead or not, as this will affects the 
animations. Or pnally, another Boolean named | s At tacking to depne whether it is 
really attacking; this will affects the animations too: 


//The health of the enemy 

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Enemy 
Behavior") 

float TotalHealth; 


//The range for the enemy attack 

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Enemy 
Behavior") 

float AttackRange; 


//The power of the enemy attacks 
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UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Enemy 
Behavior") 


float AttackDamage; 


[/ Check if the enemy is dead or alive 


UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Enemy 
Behavior") 


bool IsDead; 


/|Check if the enemy is dead or alive 


UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Enemy 
Behavior") 


bool IsAttacking; 


Then comes one of the most outstanding components of the Unreal Engine, called 
the sensing component. This is basically a component used with AI in order to give 
the characters the ability to hear or listen to anything around them: 


//The sensing component used to see or hear the player 
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Enemy Al") 
class UPawnSensingComponent* PawnSensor; 


Then there is the behavior tree component. Yes, we have created the behavior tree 
asset. Later, we will be building its logic, but the Al needs to know which behavior 
tree is driving its behaviors. That's why we will be adding it in the form of a 
component to theEne my class: 


//The used BT with that enemy 
UPROPERTY(EditAnywhere, Category = "Enemy AIL") 
class UBehaviorTree* EnemyBehavi orTree; 


Then, I've declared three major attacking functions. One will be called to perform the 
attack itself, with all an attack means. The other two play avery major role; one will 
be called before the attack in order to prepare for it and the other one will be called 
after the attack to clean up after it. 


|'ve used this approach basically to control the trigger, because if the functions are 
enabled all the time, they will be registering too many hits to the player. But with this 
approach, | guarantee that one enemy hit will register once within the physics engine: 


//Perform attack 
UFUNCTION( BlueprintCallable, Category = "Enemy Al") 
void OnPerformAttack(): 


//Applied before performing an attack 
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UFUNCTION( BlueprintCallable, Category = "Enemy Al") 
void OnPreAttack(): 


//Perform attack done 
UFUNCTION( BlueprintCallable, Category = "Enemy Al") 
void OnPostAttack(); 


As we have used a sensing component in order to hear and see through the 
environments, I've decided to create two main functions, one for hearing and 
one for seeing, but both are based on the sensing component: 


//Hear the player's noise using the sensing component 
UFUNCTI ON( ) 

void OnHearNoise(APawn *OtherActor, constFVector&Location, float 
Volume); 


//See the player's by sight using the sensing component 
UFUNCTI ON( ) 
void OnSeePawn(APawn *Ot her Pawn) ; 


Now, because I've created triggers for the hands, | want them to affect the player in 
several ways, such as decreasing his health, displaying a screen shake, and so on. 
That will be done when I'm able to detect the trigger overlap: 


UFUNCT! ON( ) 

void OnHandTriggerOverlap(classAActor* OtherActor, 
classUPrimtiveComponent* OtherComp, int32 OtherBodylndex, bool 
bFromSweep, constFHitResult& SweepResult) ; 


Finally, just in case! want to get the trigger of the whole body (not from the hands’ 
ones), | will set it within its own get t er function to return it anytime: 


FORCEI NLINEclassUSphereComponent* GetBodySphereTrigger() const { 
return bodySphereTrigger; } 


Now, as everything is well declared within the header ple, let's go ahead and work 
on the implementation of the code within the source ble itself. 


Enemy.cpp 


TheEnemy source ple might look complex the þrst time you open it. But when you 
break it down into pieces and refer each piece to the header ble description, you'll 
ond that all the logic is easy and makes sense in terms of our goals. 
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As with any of the other source or header ples, this one has to start with thei ncl ude 
statement for the different header bles. While you might be familiar with all of the 
included header bles, here, I've presented new one, PawnSensingComponent.h, 
which is used for the sensing of Al: 


#include "Bellz. h" 

#include "Enemy. h" 

#include "“EnemyAl Controller. h" 

#include "Gladiator. h" 

#include "Perception/PawnSensingComponent. h" 


The constructor looks huge and even larger than the constructor of the player itself, 
but this is because we have to construct several components and the majority of them 
are triggers to attack the player and get them damaged: 


AEnemy: : AEnemy( ) 

{ 
//Tick needed or no, it's a default from UE 
PrimaryActorTick. bCanEverTick = true; 


//Set the Al Controller class. 
AlControllerClass =AEnemyAl Controller::StaticClass(); 


//Set the enemy behavior values 
Total Health = 100; 

AttackRange = 100; 

AttackDamage = 10; 

IsDead = false; 

IsAttacking = false; 


//Because the enemy have to rotate to face the running direction, 
The Yaw rotation needed! 


bUseControllerRotationYaw = true: 


/*Build the sensing component, and set the required values for it. 
You can publicate some 


variables to control those values, but for my Al within this game, 
it is fine to just set some base values here*/ 


PawnSensor = CreateDefaultSubobj ect <UPawnSensingComponent >( TEXT( "Pa 
wn Sensor")); 


PawnSensor->Sensinglnterval = .25f; // 4 times per second 
PawnSensor->bOnl ySensePlayers = true; 
PawnSensor- >Set Peri pheral VisionAngle(85.f); 


bodySphereTrigger = CreateDefaultSubobj ect <USphereComponent >( TEXT("B 
odyTriggerSphere")); 
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bodySphereTrigger->SetSphereRadius(150.f); 
bodySphereTrigger->AttachTo( Mesh); 


FColor handsTriggersColor = FCol or (0, 0, 255, 255); 


leftHandTrigger = CreateDefaultSubobj ect <USphereComponent > 
(TEXT("LeftHandTriggerSphere')); 

leftHandTrigger->SetSphereRadi us(70.f); 

leftHandTrigger->AttachTo( Mesh, "hand If", 
EAttachLocation::SnapToTarget) : 

leftHandTrigger->ShapeColor = handsTriggersColor; 

leftHandTrigger->bGenerateQverlapEvents = 0; 


rightHandTrigger = CreateDefaultSubobj ect <USphereComponent > 
(TEXT( "Right HandTriggerSphere"))}: 

ri ghtHandTrigger->SetSphereRadius(/70.f):; 

rightHandTrigger->AttachTo(Mesh, "hand rt", 
EAttachLocation::SnapToTarget) : 

rightHandTrigger->ShapeColor = handsTriggersCol or: 

rightHandTrigger->bGenerateOverlapEvents = 0; 


//Just make sure to not use the Enemy:: Character capsule as the 
Navigation collision, and use the agent and set its radius to 
Something fits the enemy size 

//the main goal is to avoid as much as possible the cases when the 
enemy meshes intersecting with each other, or with the environment 

Get CharacterMovement()->NavAgent Props. AgentRadius = 400.f; 

Get CharacterMovement()->SetUpdateNavAgentWthOwnersCollisions(fal 
se); 


} 


Everything starts with depning the value of the variableAl ControllerClass and 
setting itto theAEnemyAl Controller that we have just created. | managed to set 
some of the default values, such as theheal th anddamage values. You still can 
change them from within the editor, but | decided to test values and put some of 
them here as defaults. 


Because the Al has to keep rotating toward the movement direction (forward), | 
managed to set the value of the Boolean bUseControllerRotationYaw, whichis 
a default bool within any character-based class, tot rue. 
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Then came the time to create the very interesting seeing component we named 
PawnSensor.1| created itusingCreat eDef aul tSubobj ect and then set some of its 
default parameters, such asSensi ngl nterval to deþnethe interval of searching and 
bOnl ySensePlayers totrue, to make sure no other Al creatures will be detected. 


After this, | started to build the triggers. As we discussed earlier, there will be three 
triggers, one for the body and two for the hands. So, | used Creat eDef aul tSubobje 
ct <USphereComponent > in order to create all of them. Then, | set the radius for each 
of them and pnally, attached them to a target. Sometimes, the main character mesh 
was the target, while with the hands | was targeting skeletal bones, such aShand_| f 
Orhand rt. 


To make sure that my hand triggers will be generating overlaps that will be affecting 
the player capsule, | managed to setbGenerateOverlapEvents too. 


To make everything look a lot clearer in the editor, I've created a color variable, 
named ithandsTriggersCol or, and set its value to the hand triggers via the 
ShapeCol or member variable, so | can differentiate then from all the other triggers. 


The last and the most effective part of the constructor was related to the navigation 
mesh. | managed to set theNavAgent Props. Agent Radi us radius to a value 

that pts my bear character, and disabled it, using the character collision for the 
navigations. Using the agent is more effective and this was done by switching off 
SetUpdateNavAgentWithOwnersCollisions. 


| left the default functions, such asBeginPl ay andTick,asthey are, as none of my 
logic will yet that targets them. | didn't manage to delete them, as | might need them 
to expand my system in the future, but it was enough to switch of theTi ck function 
from the constructor. 


//Called when the game starts or when spawned -> Default by UE 
void AEnemy:: BeginPlay() 
{ 
Super: :BeginPlay(); 
} 


//Called every frame -> Default by UE 
void AEnemy::Tick( floatDeltaTi me | 
{ 
Super::Tick({ DeltaTime }; 
} 


//Called to bind functionality to input -> Default by UE 
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void AEnemy::SetupPlayer!lnput Component(classUl nput Component * 
Input Component) 


{ 


Super::SetupPlayerlnputComponent(Ilnput Component); 


} 


| used Post!l nitialize,asitis required herein order to register the delegate 
functions for seeing and hearing, These functions comefromPercepti on/ 
PawnSensi ngComponent.h that we've included at the top of this source ble 
Then, | registered OnBegi nComponent Overlap tothe local function we made 
in the header ble. 


So, using the Post! nitialize wasa good choice, as it takes place beforeBegi nPl ay: 


void AEnemy::Postinitial!zeComponents() 

{ 
Super::Postinitial!zeComponents(); 
PawnSensor- >OnSeePawn. AddDynamic(this, &AEnemy: : OnSeePawn) : 
PawnSensor- >OnHearNoise.AddDynamic(this, &AEnemy:: OnHearNol se); 


|| Register to the delegate of OnComponent Begi nOver| ap 


leftHandTrigger->OnComponent BeginOverlap.AddDynamic(this, 
&AEnemy:: OnHandTrigger Over! ap) ; 


rightHandTrigger->OnComponent BeginOverlap. AddDynamic(this, 
&AEnemy:: OnHandTrigger Over! ap) ; 


} 


Then, the most important part about this enemy is attacking. Theat t acki ng method 
itself is kind of useless, because the way | decided to go with this Al madethe 
PreAttack andthePost Attack methods the most important ones. 


The plan is at the behavior tree; the Al will be moving toward the player. Once it 
reaches the player, it will attack. 


The attack itself is just an animation tick that will be played, no more. But the idea 
here is that, when the attack starts, we call the OnPreAttack function, and by the end 
of the animation we will call theOnPost Att ck function. Both functions work only 

on enabling and disabling the attacking triggers, which are both in the hands of the 
Al. Later, by the end of the chapter, I'll discuss how we will call both through the 
animation notipcations: 


void AEnemy:: OnPreAttack() 
{ 


leftHandTrigger->bGenerateQverlapEvents = 1; 
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rightHandTrigger->bGenerateOverlapEvents = 1; 


FString message = TEXT(">>>>>>>>>>> Attack just going to start 
LLELLE LELEL is 


|| GEngi ne- >AddOnScreenDebugMessage(-1, 2.f, FColor::Red, message); 
} 


void AEnemy:: OnPostAttack() 


{ 
lIsAttacking = false; 


leftHandTrigger->bGenerateQverlapEvents = 0; 
rightHandTrigger->bGenerateOverlapEvents = 0: 


FString message = TEXT(">>>>>>>>>>> Attack just finished 
ae ee 


//GEngine- >AddOnScreenDebugMessage(-1, 2.f, FColor::Red, message); 
} 


After enabling the triggers for the hand from the 0nPr eAt tack function, if the player 
was still in his position and didn't move, it means that the triggers from those hands 
will be touching the player's collider 9 capsule and that will trigger an Over! ap event. 


That was the whole point. We will check when the hand trigger is active (from the 
OnPreAttack function) and itis touching the player, which istheAG! adi ator type 
of class. Then, the function OnChangeHeal thByAmount ofthe player will be called 
with a speciþc amount in order to decrease the player's health. Anything else will 
happen from the player side, as in the previous chapter, for the shake or claw display 
on top of the screen. 


Most importantly we need to disable the triggers again, so they do not keep 
decreasing the player's health: 


void AEnemy:: OnHandTriggerOverlap(classAActor* OtherActor, 
classUPrimitiveComponent* OtherComp, int320therBodyl ndex, 
bool bFromSweep, constFHitResult &SweepResul t) 


{ 
AGladiator* const _tempGladiator = Cast <AGladiator>(OtherActor); 
if ( tempGl adi ator) 
{ 
FString message = TEXT( "=== HIT PLAYER WITH HAND ==== "); 
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GEngi ne- >AddOnScreenDebugMessage(-1, 2.f, FColor:: Red, message); 


//in case it hit the player, it is good idea to disable the 
triggers, this way we'll make sure that the triggers will not over 
calculate with each single hit 

leftHandTrigger->bGenerateQverlapEvents = 0; 

rightHandTrigger->bGenerateOverlapEvents = 0; 


_tempGl adi ator->OnChangeHealthByAmount(5.f); 


} 
} 


Now, both classes are running þne. You can keep adding more logic to þt your 
design and idea, but remember, once you're done, do compile the code either from 
the editor or from Visual Studio. This is the only way to get the new code to work! 


Building the behavior tree 


The behavior tree is just a bunch of scenarios and calls for various functions. The 
core function we have already written into the C++ classes, but we will never be able 
to just directly use them within the behavior tree. That's the reason behind having 
the other supportive assets, such as the task, blackboard, and service. So, in order to 
build the BT, we need to prepare the other assets. 


Å Blackboard: After you open the blackboard, you'll find it looks empty, and as 
it is adata holder asset, we will need to add some data that matches the data 
we wrote about within theaAl Controller class. You can simply add data 
using the New Key button in the top-left corner of the blackboard editor. 


a 


a 
New Key 
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Now, you can keep adding the keys (variables) and changing their names 
and types in order to fit the C++ code we have already done. Personally, | 
ended up with these three, and while we need only two, | made one more 
just while trying to expand my AI functionalities. 


a 


Pa 
New key 


adkeys 
Enemy 
SelfActor 
Enemy Position 





Now, the last thing we need from the blackboard is to assign the base 
blackboard of the behavior tree. So, you can double-click to open the 
behavior tree asset we made. On the right-hand side, there is a huge D etails 


pane! that usually holds one option, which is the Blackboard Asset. From its 


selection drop-down menu, choose our blackboard asset. 


-*. Details 


4 Behavior Tree 


Blackboard Asset Enemy Blackboard 





Å BTService: If you double-click to open the service blueprint we made earlier, 


you will find it holds a method called Event Reci eveTi ck. Thisisjustlikea 
normal Ti ck method, but this one could be changed to not call every frame. 
That's one of the difference, between Services and Tasks. This is basically 

the reason behind using this blueprint type. 


Now, with a simple cast to get to owner actor, we can check whether itis an 
EnemyA|Controller-based class or no. If it is, then we just call the function 
OnSearchForEnemy fromthe C+ code. 
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That's all this service is going to do. 


© Event Receive Tick [ >> Cast To Enemy AlController f 3 IsValid 


bT 


è — p > — BD Exec Is Valid [> 


Owner Actor Object Cast Failed [> Input Object Is Not Valid wo 


Delta Seconds O» As Enemy AlController — 

n J On Search for Enemy 

J Get Enemy my AlConti 
arget is <] p 


Target Return Value 
Target 





Å BTTask: Within thetask, we will be doing almost the same thing as the service. 
But the difference here is that we will be just calling OnPerformAttack from 
the C++ code. 


>» Cast To EnemyAlController 5 >> Cast To Enemy 5 l f On Perform Attack 
> & è > 
| & b 
Object Cast Failed > Object Cast Failed > ) 


Target 


As Enemy AlController As Enemy 


"F Get Controlled Pawn J Finish Execute a 


Target Return Value È 
Target | self | Target | self | 


Success [) Success A 





Still, there are few differences you have to bear in mind. They are as follows: 


Å Because a task is not called all the time like the service, the logic is connected 
inEvent Reci eveExecute. 

Å After the casting is successful to AlController, we can check for the Ene my 
class and cast for it, because the method we want to execute Is inside the 
Enemy class. 

Å Thereisanodecalled Fini shExecute. You haveto put it at the end of all the 


logic branches, because without this node things will go weird. But using it 
will guarantee that the behavior tree will continue after a task is done. 


N ow, with all the supporting assets done, you can easily assemble the behavior tree. 
There aren't too many types of nodes that you can use inside a behavior tree, and 
this makes it easy to construct it. Anything you need will be found on the right-click 


context menu. 
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Now isthe timeto build the actual behavior tree itself, and while we spend some 
time building its component, we only need task and service, and we have already 
assigned the blackboard to it and blled the blackboard with the data we want to keep 
up-to-date. At the same time, we built the C+ logic that is essential for the enemy 
behaviors. Building the tree itself is a matter of putting in some composites, nodes, 
and decorators. 


Now, all you haveto do is to build the behaviors logic. All the types we discussed 
before are inside the right-click menu. 


L ROOT 
EnemyBlackboard 


l 


t Sequence 
Sequence 


o] z 
<e EnemySearchService 


EnemySearchService: tick every 0.20: 


Peai Ta 


[_] Blackboard “+ Wait 
( aborts self ) Wait: 4.0s 
Blackboard: Enemy is Set @ 


“ Sequence 
Sequence 


É \ 


© ® 
„+ Move To = Simple Parallel 
MoveTo: Enemy SimpleParallel: finish with main task 


pa \ 


=f +. MoveDirectly Toward 
=¥ Enemy Attack Task MoveDirectly Toward: Enemy 
EnemyAttackTask 


E 
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My tree will start itself from the C++ code, after theposses function is called. That's 
what is called the ROOT. Then | used the following sequences: 


L. 


| used a sequence, which means that all its children will be an ordered series 
and you can tell that from the numbers at on the right of the nodes. Then, 

| set a service for it; this service is the one we created as aBTService asset, 
which is responsible for searching the player. 


The sequence itself of the previous node Is one of two things: either wait for a 
specifc time or run another sequence. 

The other sequence is going to use the enemy data from the blackboard to 
move the Al to the player (enemy here means the enemy of the Al, which is 
the player). 

Then, the other part of that last sequence is something called simple parallel, 
which is basically an execution of different things at the same time. But it will 
only get executed when the previous one (move to) is done, which means 
that we are already at the player's position. 


Thesimple parallel holdstheenemy attack task and aMoveDirect! yToward 
behavior node, which has the enemy (the player) as its target. 


Finally, the whole thing will keep redoing itself! 


Creating the blueprint 

As wediscussed earlier in Chapter 2, Setting U p Y our Warrior, when we pnish creating 
the C++ code, it is not usable until we build a blueprint based on it. That's in the 
majority of cases, and it's the case here. 
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In order to put an instance of the Enemy class into the level, we have to havea 
blueprint based on it prst, in the same way you used to create blueprints. But this 
time, the base class will beEnemy , as this is the main class we want to use for it. 


u 


a Common Classes 


s Player Controller 


L Actor Component 
W Scene Component 


a All Classes 


4@ Controller 
+ 


ay 


AlContrall 
AlCGontraller 


Pick Parent Class re] 


An Actor is an object that can be placed or spawned in the 
world. 

A Pawn is an actor that can be ‘possessed’ and receieve 
input from a controller. 

A character is a type of Pawn that includes the ability to walk 
around. 


A Player Controller is an actor responsible for controlling a 
Pawn used by the player. 


Game Mode defines the game being played, its rules, scoring, 
and other facets of the game type. 


An ActorComponent is a reusable component that can be 
added to any actor. 

A Scene Component is a component that has a scene 
transform and can be attached to other scene components. 


` 6EnemyAlController 


dO BTNode 
4© BTAuxliaryNode 
A (Ç) BTService 


4() BTService_BlueprintBase 
© EnemySearchService 





Select Cancel 


But as you remember, we will always need to change default values. Despite this, 
you can set almost all the values within the constructor of the class, but still some 
values will be faster to set within the editor itself. 
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I've changed some settings, such as the animation blueprint value I've set to use the 
Bear_animationBlueprint that I've created especially for the bear enemy. 


4 Animation 


Animation Mode Use Animation Blueprint + 


Anim Blueprint Generated Class BearAnima+ Se BE © 





Because the blueprint we are pnishing here is for an Al, there are even more values 
we have to set. For example, my Enemy and Al Control! er code has a reference for 
the used behavior tree. I've listed it to be within a category named Enemy Al . Then, 
simply browsing for the BT is essential, otherwise the enemy will not start following 
any BT. 


4 Enemy Al 


Enemy Behavior Tree Enemy BT 





Because the enemy is based on a character, with lots of premade logic to bt different 
behaviors, and that's a default from Unreal, | worked on disabling the unneeded 
behaviors from the M ovement Capabilities section. 


To be honest with you, leaving these will not have any effect, as for example the 
enemy will never jump until you depne that in code, add it to a task, and set it inside 
the behavior tree. But the point is, what if a designer or another colleague Is looking 
into the whole thing? If the jumping capability was marked t rue, he would think the 
enemy is not jumping, because the code has some errors. But marking It aSf alse, 
means it is not used here, or in the code! 


4 Movement Capabilities 
d Movement Capabilities 
Nav Agent Radius 
Nav Agent Height 
Nav Agent Step Height 
Nav Walking Search Height Scale 


Can Grouch 


Can Jump 


Can Walk 
Can Swim 


Can Fly 





== 
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One last thing; we have created an AlController-based class that is called 

EnemyAl Control! er, but this class is not used yet. We didn't create a blueprint based 
on it. We didn't reference it within the Enemy C+ class. But then, how this is going 
to work and how will the most important function of it (dedicated to searching for 
the player or storing data within the blackboard) be done? 


Well, any pawn, by default, has an option to setAl Control lerClass.If you left it to 
none, it means that the pawn is not an Al; but if itis the Al that is going to navigate, 
then you have to set a value here. 


4 Pawn 


Use Controller Rotation Pitch 
Use Controller Rotation Yaw 

Use Controller Rotation Roll 

Can Affect Navigation Generation 


Auto Possess Player Disabled 


BER B 
4 


Auto Possess Al Placedin World + 


Al Controller Class EnemyAlController~ 7 ewe 





Finally, with all in place and with the triggers we have created through the C++ code 
and animations in place, this is how my enemy sample looks and it is ready to be 
Spawned in the map: 
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Remember a few pages ago, when we created the animation blueprint? Or, to be 
more precise, when | showed my animation blueprint setup and you used the 
knowledge you have from Chapter 1, Preparing for a Big Project, and Chapter 2, Setting 
U p Your Warrior, to build your own animation blueprint setup for your Al? 


There was one more thing that | didn't want to add to the animation blueprint at that 
time, as it is was more dependent on the C++ code. It is the animation notibes. 


We have discussed before the importance of noti þcations and how accurate they are 
when it comes to executing something at the exact moment. 


Within the C++ code, we have written two important functions and the loss of 
gameplay logic will count on these two functions; it was theOnPreAttack and the 
OnPost Attack methods. Both the functions do handle each other; the OnPr eAt t ack 
method works on preparing the enemy to do an attack and theOnPost Att ack 
method works on returning everything to normal. 


But when we decide that the attack is about to happen, can we prepare for it? And, 
when we decide that the attack is done, can we reset things to normal? 


Well, it is simply through the animations! 


At the start of each attack animation, we can call OnPreAttack, asthisis exactly 

the moment where the attack will start. And so, at the last few frames of the attack 
animations, we can call OnPost Att ack, aS this implies that the attack animation was 
already completed. 
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This said, the only thing left to do Is just put the two notipcations within all the 
attack animation clips that | have. 


Previewing Animation ExoGame_Bears_Attack_Melee 


LOG: t) 

Current Seraan Swe 1.00 
Triangles: 5028 

Yartices: J306 

UY Channels] 


arry ipsa al fade ol al | en 
Appros Se 4) 644854905 


Exoamne Beans Atat 


a Notifies 


ee p 
| 





Then, from within the animation blueprint, it is simple to just call OnPost Attack and 
OnPreAttack fromthe C+ code and apply them to the notipcations. 


>> Cast To Enemy 
eee — D- 


Object Cast Failed [> Is Attacking 


SET 


As Enemy - 
Is Attacking — 


is Dead 


J On Post Attack 


©} AnimNotify_OnEndAttack © 
SSS SS SSS eae — D D 


Target 


©} AnimNotify_OnPrepareAttack © 


b TNE 


Target 
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What else? 


Well, when we create an Al for a game, we keep updating it within each update, 
not only for the sake of bug pxing, but also adding new features, making it more 
accurate and more live! 


Now, | would recommend you to do two main things. First, go ahead and add more 
and more tasks, services, and code to it to make your Al decide more, I'm limited 

by the page count, but don't be limited by your imagination; go ahead and imagine 
more behaviors and add them to your enemies. 


| would also recommend you to gather all what learned so far and try to build anew 
class that is responsible for soawning enemies; some games have enemies already 

in their maps, but the majority of the games spawn enemies at runtime, so why not 
build such a small system? 


Otherwise, you can drag and drop instances of the enemy blueprint within the scene 
at the positions that you want them to start in, and they will do the rest once the 
game starts! 


Summary 


Now, you have created the most complex and funny part of this game and game 
development in general. 


You have got an idea about how huge Al systems are built and how inheritance 
usually goes for the different Al classes. Even if your Al is going to be simple 
enough, it is good to understand how huge projects handle it. 


TheAl system within Unreal Engine has several different assets, all of them have to be 
used in order to create a complete Al system; you can ignore some, but using them will 
empower your work. Blackboards are essential to save data for the Al, while services 
and tasks work as procedures for the Al, but each does that in a different manner. All 
of the previous asset types have to be handled within the amazing BT editor, within 

a BT asset, and you have learned how to do that. Not only what the BT is and how to 
use it and its editor, but also you've learned how to use the most interesting parts of it, 
such as decorators and composites; you now have mastered them. 


The animation blueprint is essential for any animated entity within your game; the 
more complex your blueprint gets, the more life it gives for your characters and 
entities, and you have practiced in using them here again. 


[131] 


The Road to ThinkableAl 


TheAl core C++ logic is the soul of everything the Al can do; all the assets and 
behavior trees take their orders from here and now you have done one more practice 
in coding complex things within Unreal Engine. Regardless of the base class of your 
enemies, you have learned that any Al needs an Al Controller class to drive it; that's 
how navigations works, and you have done it perfectly. 


Creating the blueprint is always the last step, just to make an Instance of your class to 
be used within the game. Regardless, you will be directly throwing it inside the map 
or spawning it at runtime; you must create at least a blueprint based on the class and 
set all its parameters to match your design. 


What if we want to call some parts of the code at a certain moment, but we are not so 
sure when this moment will come? Well, animation notipcations have always been the 
trick, and you have now done them in avery wide form, such as giving orders to the 
Al before and after doing attacks; this is a good skill in its own right, not because of 
something more than that usually the blueprints handled by the artists, and the code 
handled by the codes, but this is the gray area between black and white, it is donein 
the asset side, but it needs coding skills, and you understood it perfectly now. 


With all of these in place, play your game, bx what needs to be pxed, and let's go 
ahead and take another C++ coding challenge: in-game collectables. 
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What is the point of playing a game without being able to win?! It is the main 
purpose of a game, that you win, right? But how do you win? 


Well, winning varies depending on the game's genre, but there is one thing in 
common between all genres: almost all games have collectables. 


Now the equation is simple: in order to win, you have to collect some stuff. Take 
Super M ario as an example; this was my þrst time learning about the importance of 
collectables, and this game was all about collectables. Yes, of course, if you run out 
of time, you lose, but you can collect time as an item to Increase that limit. 


Even in an AAA shooter, or a similar hardcore game, you would never make it 
to the end of the level without getting some health pickups, or food in the most 
recent games. 


So in a nutshell, collectables are essential. Regardless of the genre, you'll pnd 
yourself ending up with having at least one type of collectable item in your 
game. That's what we are going to discuss. 


By the end of this chapter, you'll be able to: 


Å Understand the different ways of building a collectables system 
Construct a collectables hierarchy 

Create aCoi n class based on the Base pickups class 

Build the blueprint of a collectable 

Useover| ap events to detect the surrounding actors 


> > Jo To 


Å Increase a variable amount based on the collections 


N ow, let's get started. Open your game, or your Bellz, and let's add some collectable 
items to it! 
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The idea behind collectables 


If you are following this book chapter by chapter, that means you have already 
completed the Al chapter, and you already have an idea about how things should 
be constructed. But let's be more specifc here. 


There are different ways, methods, and approaches that we can use in order to build 
a collectables system. The variation comes from the fact that not all games are made 
the same way, and engineers do not necessarily work using similar methods. But the 
two most common methods I've found that we can use are as follows: 


Å Webuild a base collectables class, and then we build some classes inherited 
from it, each new subclass serving a different type of collectable item. For 
example, we could have the main Pi ckupBase class for the general behaviors 
shared between all pickup items, and then derive several classes from it, such 
aSmoney,health,food, and soon, where each type of collectable will behave 


differently. 
PickupBase 


= = 
= =— 











= 


“HeathPickup | | FoodPickup | MoneyPickup 
i. ae =z 3 =i 
© ©0900 © 
PaK , 5 i = 
(=) - 
neni ; 


Å Ontheother hand, we could have just one collectable class. Based on 
something (let's say a tag or object instance name), we could apply a 
different scenario after the item is picked up. 
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PickupBase 
Health Devil 
om) QOON (-) 


Despite this, there are unlimited ways by which you can classify such a thing, but 
these are the two most common methods | have found within projects. It's interesting 
that these methods are in two different directions; while one tends towards a 
detailed control over each type, the other just puts all collectables into one plot. 

Each has its own advantages and disadvantages that you can learn by experience! 











While! usually like to use the prst method, you will mostly pnd yourself using the 
second one, as it requires less implementation, fewer classes, and usually less typing. 
But to be honest with you, what makes good code better than bad code is not the 
code quality or amount as much it is about the code design and structure, and how 
extendable and yexible it is. Flexibility is something you get from the prst method. 


While we followed one approach while building the enemies, let's use a different 
technique for the collectables: let's have a base class and child classes. 


The base class 


The base class will hold the major behaviors and instructions for all the collectables. 
Go ahead and create a new class based on theAct or class and nameitPi ckupBase. 
Once Visual Studio opens, let's write some code for It. 


PickupBase.h 


Asall we have to do (so far) for this class is based on theAct or class, | didn't have to 
include something special for its header ble. At the same time, write the code for the 
depning the constructor and the class: 


#pragma once 


#include "GameFramework/ Actor. h" 
#include "PickupBase. generated. h" 
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UCLASS() 
class BELLZ API APickupBase : public AActor 


{ 
GENERATED_BODY( ) 


public: 
// Sets default values for this actor's properties 
APi ckupBase() ; 


Then you can remove the depnition set of the default two functions, but | kept them 
just in case | need them in the near future: 


// Called when the game starts or when spawned 
virtual void BeginPlay() override; 


// Called every frame 
virtual void Tick( float DeltaSeconds ) override: 


As the coin pickup (or any other pickup) will havea static mesh to represent it 
inside the game world, | made a get function called Get Mesh to return a type of 
UStaticMeshComponent , Justin case it Is needed: 


//Return the static mesh of the pickup instance 
FORCEINLINEcl ass UStaticMeshComponent* GetMesh() const { return 
ThePickupStaticMesh; } 


Because these pickups have to be collected, at some point a pickup needs to be 
hidden. | did this by adding a Boolean called | s Acti ve that holds the activity status, 
and a method called Set Act i ve that takes a Boolean as its parameter, in order to set 
the activity at any given moment: 


//The pickup active or not! 
UFUNCTI ON(BlueprintPure, Category = "Pickups") 
bool IsActive(); 


// Change the active status fromthe outside 
UFUNCTION( BlueprintCallable, Category = "Pickups") 
void SetActive( bool NewPickupSt ate) : 


Now that picking up and switching activities are mentioned, | decided to add 

the function that will be responsible for picking up the collectables. | called it 
OnGet Coll ected, and then I created the virtual OnGet Col |ected Implementation 
function that will be used with the inherited child classes (Such as the Coi nPi ckup 
class): 


//When the pickup gets collected, this function should be called 
UFUNCTI ON( Bl ueprintNativeEvent ) 
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void OnGetCollected(); 
virtual void OnGetCollected_| mpl ementation(): 


Finally, | managed to create aUSt ati cMeshComponent component and named it 
ThePi ckupSt aticMesh, and this is where we will be holding the collectable mesh 
and/ or its visual representation: 


//The static mesh of the pickup, to give it visual looking, you can 
replace it with Sprites if it is a 2D game 


UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Pickups", 
meta = (AllowPrivateAccess = "true")) 


class UStaticMeshComponent* ThePickupStaticMesh: 


Now the header ble is complete. As you can see, there isn't anything unusual, 
just methods to be used when the pickup is actually collected, or methods to 
inquire about things. While all this is fresh, let's go to the source ble and start 
the implementation of this stuff. 


PickupBase.cpp 


As always, it all starts with the set of included header bles. But nothing very 
important was added here, other than the default ones: 


#include "Bellz. h" 
#include "PickupBase. h" 


After that, it's time to add the constructor. Remember, | might be able to use the 
constructor to add a mesh, or a certain type of physics, but! always prefer to keep 
those types of parameter within the editor. | mean that the parameters that | will 
need to set once and for all | prefer to do in the editor; otherwise, if the parameter 
needs some tweaks, it is better to set it here, in the constructor. 


| also managed to set Pri maryActorTick. bCanEverTick tofalse,asl haveno 
intention of using thet i ck method for any logic; thus it is better to disable it. 


Last but not least, | initialized and created theThePi ckupSt aticMesh variable of the 
USt ati cMeshComponent component type and set it to the root of the object: 


I} Sets default values 
APi ckupBase:: APi ckupBase( ) 
{ 


// Set this actor to call Tick() every frame. You can turn this off 
to improve performance if you don't need it. 


PrimaryActorTick. bCanEverTick = false: 
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// All pickups start active 
blsActive = true; 


|| Add the static mesh component 


ThePickupStaticMesh = CreateDefaultSubobj ect <UStaticMeshComponent >(T 
EXT("PickupMesh") ) ; 


RootComponent = ThePickupStaticMesh; 
} 


The two main methods, Begi nP| ay andTi ck, are left as is. If you want to remove 
them, just remember to remove them from the header ble prst; otherwise, there is no 
effect on the performance, especially because! have disabled theTi ck method from 
within the constructor: 


// Called when the game starts or when spawned 
void APickupBase:: BeginPl ay() 


{ 
Super: :BeginPl ay(); 


} 


// Called every frame 
void APickupBase::Tick( floatDeltaTime ) 


{ 
Süper: Tick{ Del taTime ); 


} 


Then, the small simple method to return the active status of the object was made. It 
is Important, in some cases, just to make sure the coin/ collectable is active before 
collecting it: 


// Getter to the active status 
bool APickupBase::IsActive() 
{ 


return bl sActive: 


} 


The last and most important part of the coin codeisOnGet Collected_ 

| mpl ement ati on, where we can execute any necessary code once the item has been 
collected. For now, it is enough to print a message to the screen, but this is the place 
that will be used to soawn some particles later: 


void APickupBase:: OnGetCollected_ | mpl ement ati on{ ) 


{ 


//Display to screen 
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FString message = TEXT(" == Successfully Picked up == ") + 
Get Name(); 


GEngi ne- >AddOnScreenDebugMessage(-1, 2.f, FColor:: Red, message); 
} 


The coin class 


The coin class is a child class, derived from the base class, and it will only hold the 
behaviors and instructions required for coins. Go ahead and create a new class based 
onPickupBase class, and nameitCoi nPi ckup. Once Visual Studio opens, let's write 
some code for it. 


CoinPickup.h 


As the coin has nothing special to do except hold its own value, the amount of 
increase that it will give to the player when it is collected, | managed to just add the 
override for the virtual function OnGet Col | ect ed from the base, and a yoat named 
Coi nVal ue. We can set its value either in the constructor or in the editor: 


#pragma once 


#include "PickupBase. h" 
#include "CoinPickup. generated. h" 


TEX 
* 
£ 
UCLASS() 
class BELLZ API ACoinPickup : publicAPickupBase 


{ 
GENERATED_BODY( ) 


public: 
// Sets default values for this actor's properties 


ACoi nPickup() ; 


|} The Override for the Virtual of the base class 
void OnGetCollected_ I mplementation() override: 


//Access the Coin value 
float GetCoinValue(): 
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protected: 

//The value that the coin adds to the collected items, you can m 
a Special coins with higher values or so.. 
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Coins", 
(BlueprintProtected = "true")) 
float CoinVal ue; 


ie 


While we have some kind of value, | managed to add a basic getter function, 
Get Coi nVal ue, that will return the value of this coin, just in case | need it. 


CoinPickup.cpp 


As the class header doesn't have much to implement, it was enough to do the 
following in order: 


Å Giveabase value for the coin Coi nVal ue in the constructor 
Å Return theCoi nVal ue within the getter function Get Coi nVal ue() 


Å Finally, write down the override of the virtual OnGet Col I ected fromthe 
parent class and add a simple actor called Dest roy() in order to destroy 
itself when it is collected 


#include "Bellz. h" 
#include "CoinPickup. h" 


//Set default values 

ACoi nPickup:: ACoi nPi ckup() 

{ 
//the base value of the coin 
Coi nValue = 205.01 


void ACoinPickup::OnGetCollected_Implementation() 


{ 
|] Use the base pickup behavior 
Super:: OnGetCollected_ | mpl ementation(); 
|} Destroy the coin 
Destroy(); 
} 
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// return the value of the coin 
float ACoinPickup:: Get CoinVal ue() 
{ 

return CoinVal ue: 


} 


Making it collectable 


Now we havea collectables base class, and we havea typeof pi ckup item, which 
is the golden coin. But if we created an instance of it as a blueprint based on the 
Coi nPi ckup Class, it will not be collected, because there is no code to make the 
character (theGl adi at or class) able to recognize the collectables. 


So, insidetheG! adi at or class, | will be adding one function, OnCol lect Pickup(), 
and it will work as follows: 


L. 


10. 


The most important thing is that we'll be using the 

Get Over! appi ngAct ors() method of the gladiator collider in order to pick 
up anything that collides with the character right away. However, in order 
to store the data found, we will need something like a container for it. 


So, the prst thing to be done Is creating an array of Act or called 
CollectedPickups. 


Then, access theCapsul eComponent component of theG! adi atorCharacter 
class (AGI adi at or ) using the word t hi s in order to refer to the current 
Instance. 


By using the array we made as a parameter for the member function 
Get Overl| appingActors, wewill be able to store all the collisions. 


Then, atypical for loop, in order to loop between all the collided objects, 
we get through Get Overl appingActors. 


Now itis just a matter of making sure the actor in this loop iteration is the 
one we want. 


And to make sure of that, | checked that itisAPi ckupBase, and not going to 
be destroyed, and is still an active instance. 


If all this ist rue, then | proceed and then call itsOnGet Col | ect ed function 
(all the pickups will have it). 


Finally, make sure it is a coin by comparing it to ACoi nPi ckup* 
const _tempCoin. 


If it is, then I'll just increase the coin's pnal value variable of theG! adi at or 
class, which is called Col | ect edCoi ns Val ue, and also count how many 
coins been collected. 


gg J 
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11. The last important part is to disable and hide this pickup by setting its 


12. 


activity tof alse. This way we make sure the coin will not be over-calculated. 
Remember, we made ourselves safe when we added the Destroy call inside 
theOnGet Col | ected_| mpl ement at i on method of theCoi nBase class. 


Finally, | print to the screen using GEngi ne, which is used in the entire game, 
just to test it: 


void AGladiator::OnCollectPickup() 

{ 
//Lets make a temp array to hold the overlapped coins 
TArray<AActor*> CollectedPickups; 


f/let's check if something overlaps the player capsule, and then 
Save the result at the temp array 


this->Capsul eComponent->GetOverlappingActors(CollectedPickups) : 


// loop within the overlapped items 
for (int32 c = 0; c < CollectedPickups. Num); c++) 


|] Cast the actor the base pickup 
APickupBase* const _tempPickup = Cast <APi ckupBase>(CollectedP 
CKUDS telis 
// If cast is done, then let's make sure that it is active 
if (_tempPickup && ! tempPickup->IlsPendingKill() && _ 
tempPickup- >| sActive()) 
{ 
/i/call the internal OnGetCollected 
_tempPickup- >OnGet Collected(); 
//Then cast to a coin, to make sure it is a coin, you can 
add different scenarios for the different types of collectables 
ACoinPickup* const _tempCoin = Cast <ACoinPickup>(_ 
tempPickup) ; 
if ( tempCoi n) 
{ 
llif it is really a coin, then lets add 1 to the amount of 
collected coins, and then add the value of this coin to the score 


CollectedCoinsValue += tempCoin->GetCoinValue(): 
CollectedCoins += 1; 


FString message = TEXT("Collected another coinCoin ---> 
Total of ") + FString::Fromnt(CollectedCoins) + TEXT(" And al 
value now is") + FString:: From nt(CollectedCoinsVal ue) ; 

GEngine->AddOnScreenDebugMessage(-1, 2.f, FColor:: Blue, 
message); 
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} 
// Disable the pickup item 


_tempPickup->SetActive(false) ; 


} 


} 


One thing to keep in mind, you'll need to add a couple of extra headers into the 
incl ude statements of theGl adi at or class, Pi ckupBase and Coi nPi ckup,in order 
to be able to access their member variables. Keep in mind that there is nothing 
called a bnished class. Sooner or later, you'll be jumping between classes, in order 
to connect them with each other: 


#include "PickupBase. h" 
#include "CoinPickup. h" 


Don't forget to deþne the function insideG! adi ator. h (the header ple): 


// Called when we collecting a pickup 
UFUNCTION( BlueprintCallable, Category = "PickupSystem') 


void OnCollect Pickup(); 


Building the blueprint 


Now, creating the blueprint is very simple, as always. Just create a new blueprint, 
but this time base it on the Coi nPi ckup class. 


AL Pick Parent Class 


4 Common Classes 


sheng is an object that can be placed or spawned in the 


8 aa A Pawn is an actor that can be ‘possessed’ and receieve 
input from a controller. 
A character is a type of Pawn that includes the ability to walk 
_ Character around. 
A Player Controller is an actor responsible for controlling a 
f» Player Controller Pawn used by the player. 
Game Mode defines the game being played, its rules, scoring, 
fe} Game Mode and other facets of the game type. 
i An ActorComponent is a reusable component that can be 
gy Actor Component added to any actor. 
S A Scene Component is a component that has a scene 
e-l ecompanat transform and can be attached to other scene components. 
4 All Classes 
up 
4O© Object 


4@ 
4@ | 


Select 
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Name it whatever you want, it will not make a difference. The method we followed 
is not affected by naming. After creating it, open the blueprint editor, and set the coin 
mesh as the mesh asset you have (feel free to get the one | made from my project by 
following the Mi grate assets from Chapter 1, Preparing for a Big Project). 


4 Transform 


Scale w 


Mobility 


d Sockets 


Parent Socket 


4 Static Mesh 


4 Materials 


lambert 
Element.0 e O 
i 


Now it's time for the last step before throwing it into the map. Just change Collision 


Presets to OverlapAll. This way we make sure it is not an obstacle for the Al, and 
doesn't block the player. 








4 Collision 
Simulation Generate 
Phys Material Oven None 
Generate Overlap E 
> Collision Presets 
Can Character Step 


F 





Throw some coins onto the map, in different places, and then hit Play. You'll notice 
that once you touch any coin with the gladiator, the coin will disappear right away; 
and its value will be added to your stock, and it will all be printed onto the screen. 
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Going forward 


Now that you havea base pickup class with one type of pickup, | suggest you do 
two more things: prst, keep building different pickups that affect the character 
differently, for example, a weapon pickup, a health pickup, and so on. 


Secondly, | would suggest you write a small class that places the pickups around 
the level. As you know, lots of games are based on randomness, but the majority of 
them are based on the design of the level. | mean, some games force us to put the 
collectables one by one around the levels at certain places, while other games are 
based on an algorithm or asystem that places pickups all around the level. 


Go ahead, bnd the best for you and do it. In Bellz, | was trying to show you the way, 
and | found it is enough to create the pickups. decide how to place them around ina 
level, and investigate. Go ahead and do it. 


Summary 


Now you understand one of the cornerstones of any game. All games have pickups, 
and they are essential for many aspects of the game. Having them is important, but 
we have to know how to add them, and you've gained this skill. 


Building afew more C++ classes, and getting more and more used to the workyow 
of coding for Unreal games, is something you spent a lot time on in this chapter. 


After creating a class, it has to end up as a blueprint to be used in levels, and you 
learned how to do that. 


Collectables without player interactions are not collectables. It is better to describe 
them as items. But in order to collect them, the player has to interact with and touch 
them, and you learned how to trigger overlap between them. 


Now, | think that this is enough code. We have been writing code for the last couple 
of chapters. Let's take a break, and let's go for some eye candy. If you are done here, 
and feel that you have practiced pickups enough, let's go ahead and make some 
particles to give some life to our game. 
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The Magic of Particles 


While the game (Bellz) looks amazing right now, if you keep playing it several times, 
you will always have the feeling that there is something not right. Something Is 
going wrong, or more accurately, something is not in the right place. Despite that, 
the game still has no music or sound effects, which will give that feeling of being 
disconnected from the reality of the game world. However, what we are missing 
here, and what we need right now, is particles. 


Is it right to leave the character running without getting some dirt out of the ground, 
based on foot-drag and interaction? Or even hitting the bears with an axe without 
getting some blood out of their bodies? It is not only dirt or blood that we need, but 
even the simplest particle systems that we can throw around the map will makea 
difference, and will make it pop with life. 


Unreal Engine appreciates that desire to make things more detailed via particles, and 
takes really good care of the concept of particle systems. It is not only about giving 
particles their own types of assets to be made and used, but also about having a huge 
and independent particle system editor, called Cascade. Not only that, but this editor 
has full support for animation curves, which is enough to take us to a whole new 
world of particle behaviors. 


And that's our mission now: get into the particles system workyow inside Unreal, 
master it, and support out game example with some particle systems. 


By the end of this chapter you will be able to do the following: 


Å Understand the structure of a particle system's assets 
Å Master the usage of the particle editor (Cascade Editor) 
Å Build any particle system you havein mind, regardless of its complexity 
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Å Useanimation curves with particle systems in order to have more control 
over them 
Å Spawn particles at runtime in different ways 
Å Change particle parameters at runtime 


Now, while we have what looks like an interesting plan, let's open the editor, and 
let's get started! 


The particles editor 


As you might already know, Unreal Engine is built in a way that makes it looks like 
it iS a composition of several mini editors: an editor for character animations, another 
for materials, one for physics, and one more for the particle system, and so on. 


Cascade is the proper editor inside Unreal Engine that is responsible for creating and 
editing particle system assets. Accessing Cascade is as easy as any other asset-based 
editor, like M aterial Editor for example. Just by double-clicking on a particle system 
asset from the content browser, you will be able to launch Cascade in a second: 
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Once the particles editor is opened, you'll pnd it is designed in the same way as all 
other Unreal editors, with different areas that give you easy access to all the needed 
functionalities to achieve the goal of that editor. The good thing about Unreal is that 
all you want is just in front of your eyes, and you don't have to navigate through tons 
of huge menus with tons of submenus. The main areas that make up the Cascade 
editor are: 


Å 1:Toolbar 

Å 2:Viewport panel 

Å 3: Emitters panel 

Å 4: Details panel 

Å 5: Curve editor 
As each section is a huge corner of the editor on its own, let's get more detail about 
those sections, and let's dive into each part, as each parameter you can change, or 


each value you can enable, will have a huge impact on the pnal result or on the 
process of building particle systems. 


Toolbar 


This contains lots of buttons for the most commonly used tools, functionalities, and 
visualization orders, which you'll need all the time. Some of the buttons might be 
hidden at the UI dueto the screen size, but in general the toolbar always contains 
the following: 


E © 6 OFYN 


Save FindinCB Restart Sim Restart Level Undo Redo 


c v 
D. ş 2 


Thumbnail Bounds Ongin Axis Background Calor 


sl ad Ms ail 
Regen LOD RegenLOD LowestLOD LowerLOD Add LOD 


LOD:GSP addLop HigherLOD HighestLOD Delete Lop 
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All the buttons you pnd at this bar come in handy when you start the building 
process; while the Cascade Editor supports lots of keyboard shortcuts, sometimes it 
is faster to hit the buttons around the bar while you are already holding the mouse! 
The following are the options available on the toolbar: 


A 


Joo Do > > > D> 


> To > > Do Jo >œ To D> D> 


Save: This saves the changes into the particle system. 


Find in CB: This points to the current particle system asset at the content 
browser. 


Restart Sim: This restarts the simulation at the viewport panel. 


Restart Level: This restarts the particle system in general, which means not 
only at the viewport, but also all the instances inside the level. 


Undo: This undoes the previous operation. 
Redo: This redoes the previous undone operation. 


Thumbnail: This saves the current frame from the viewport panel's camera 
as a thumbnail image for the particle system to be displayed at the content 
browser. 


Bounds: Thus toggles on/ off the display of the bounding shapes of the 
current particle system at the viewport panel. 


Origin Axis: This toggles on/ off the origin axis at the viewport panel. 


Background Color: This changes the color of the viewport panel's 
background. It is black by default, but it is very useful in case your particle 
system Itself is black; by changing the background color, you'll be able to get 
a better understanding. 


Regen LOD, Duplicating Highest: This regenerates the lowest LOD by 
duplicating the highest LOD. 


Regen LOD: This regenerates the lowest LOD by using values that area 
preset percentage of the highest LOD's values. 


Lowest LOD: This loads the lowest LOD. 

Lower LOD: This loads the next lower LOD. 

Add LOD before current: This adds anew LOD before the current one. 
Current LOD: This selects the current active LOD, if you have set up LODs. 
Add LOD after current: This adds a new LOD after the current one. 
Higher LOD: This loads the next highest LOD. 

Highest LOD: This loads the highest LOD. 

Delete LOD: This deletes the current LOD. 
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The viewport panel 


Just like any visual tool within Unreal Engine, such as the Material Editor, keep it 

a rule of thumb that, whenever you have to make an artistic visual piece of asset, 
you must have a small viewport inside its asset editor in order to display up-to-date 
changes while creating them. 


It is just a small viewport that is meant to give you a real-time visual feedback of the 
bnal look of the particle system. As you know, changing values, colors, and settings, 
even with the least amount of change, could have a huge impact on the pnal result. 


As with any other viewport inside the engine, it has some viewing options listed 
inside the top buttons, just like the main level viewport inside Unreal Editor. Also, 
it is responsive to the shortcuts, which means you can still navigate inside it in the 
same way you'd navigate inside your level, by using the mouse buttons or even 
some shortcuts, such as hitting F to focus on the particle system: 


View Jt Time | 


View Overlays 


View Modes 


Detail Modes 


Orbit Mode 
Vector Fields 
Grid 

Wireframe Sphere 
Post Process 
Motion 


Motion Radius 


Geometry 


Geometry Properties 





The viewing options include the following: 
Å ViewOverlays: This toggles between the different data readouts, which gives 
you lots of information about the current particle system: 


° Particle Counts: This shows how many particles are being emitted 
from each emitter at the current particle system 


° Particle Event Counts: This shows how many events have been 
triggered within each emitter at the current particle system 
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° Particle Times: This shows how long each emitter of the current 
particle system has been active 


° Particle Memory: This toggles a display of particle system memory 
usage, both for the template and for each instance 


A View Modes: The different options inside this menu allow you to switch 
between the different draw modes in the viewport panel. They are mostly 
the same as the ones inside the Level Editor viewport: 


° Wireframe: The Wireframe view mode shows a wireframe of the 
particles. If the emitter uses sprites, you will see the two polygons 
which make up each sprite. 


°  Unlit: The Unlit view mode shows the result of the particles without 
lighting or post processing. 


° Lit: The Lit view mode shows the result of the particles with lighting 
and post processing. 


° Shader Complexity: Shader Complexity displays feedback on how 
many instructions are required for a particular shader. Green is the 
lowest value, and red is the highest value. 


Å Detail Modes: The D etail M odes submenu allows you to switch the 
viewport window between low, medium, and high detail. These correlate to 
engine detail modes, allowing you to see how a particle system will appear 
at each different mode. If you are using any but the high mode, you will seea 
visual text in the left corner of the viewport, telling you that you arelooking 
at a specific one, just to save you from thinking that you are seeing the best 
quality right now: 


° Low: This previews the particle system as it would appear when the 
system detail mode is set to low 


° Medium: This previews the particle system as it would appear when 
the system detail mode is set to medium 


° High: This previews the particle system as it would appear when the 
system detail mode is set to high 


Å Background Color: This opens the color picker where you can change the 
color of the viewport panel's background. It is the same as the one you find 
on the toolbar. 


Å Orbit Mode: This toggles camera behavior between orbiting around the 
particle system and moving freely in the viewport pane. 
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Å Origin Axis: This toggles visibility for the origin axis gizmo. Works like 
the one you also find on the toolbar. The origin axis is always located in 
the lower-left corner. 


Vector Fields: This toggles on/ off any vector fields applied to the particle 
system. 


Grid: This toggles on/ off the viewport grid. It makes it easy to define the 
particle system In space. 


Wireframe Sphere: This shows a wireframe sphere representing the 
spherical radius of the particle system. 


>X > > >” 


Post Process: This toggles visibility of the global post process. N ot always 
useful, but sometimes it makes you understand how it would look in case 
your game has some post processing effects. 


M otion: This toggles between on/ off if the particle system remains 
stationary or revolves around the center of the grid. 


M otion Radius: Use its input field to set the radius of revolution for the 
Motion setting. 


Geometry: This shows or hides the default test mesh. 


Geometry Properties: This brings up the Geometry Properties window, 
where you can adjust the properties of the default geometry, adjusting 
placement, swapping out the mesh used, and many other options. 


Joo > D> D> 


Å Bounds: This toggles on/ off for the particle system bounds, just like the one on 
the toolbar. These are shown as both a bounding box and a bounding sphere. 


Å SetFixed Bounds: If you activated it, this fixes boundaries for the particle 
system and automatically sets the values to the largest setting. 


Now, let's look at the timing options: 


Wl Play/Pause 


/| Realtime 
#| Loop 
AnimSpeed + 
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Thetiming options include: 


Å Play/Pause: This plays or pauses the simulation for the current particle system. 


Å Realtime: If checked, the simulation plays in real time. Unchecked, the 
simulation only plays when something updates the viewport panal. 


Å Loop: Either the particle system plays once, or it should restart once it 
reaches the end. 


° AnimSpeed: With its submenu, you will be able to adjust playback 
speed percentage between 100%, 50%, 25%, 10%, and 1% 


The emitters panel 


You have to know the difference between the particle system and the particle 
emitter. The particle system is the actual asset itself, which means it is an asset you 
can create in your content browser, and it is the þnal look of what you are building 
inside Cascade and the one used inside the game. The emitter is the unit used to 
create a system, which means the particle system could be made out of one particle 
emitter, bve emitters, or even an unlimited amount of emitters! 


Peipietey Sey ipeaer Paar te lee Speer “Pareles Spier Pap ue le: Ermer 


| (eee amo % Boo + 4 Be z 
| 


nemmen E | Fasulet | Fistjuiree A Flequired 


Spawn ‘| Spawn m Spawn | Span 
Lifetirne A ire Lifetime ie Lifetime H Lifetirme 
Inttial Size p intial Size EE intial Size B Ej initial Size 
Initial Velocity Fi initial Velocity mr Initial Velocity E kj initial Velocity 


Color Over Life ea Color Over Life | ke Color Over Life H Color Over Life 
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AS a particle system is made up of one or more particle emitters, this is the place 
where you can add, select, edit, and arrange your emitters. Think about it as a graph 
area like the one with the M aterial Editor, or even like the Blueprint graph. This is 
where you put the actual content! 


As itis just an area for all the emitters, you can call it The emitter list, as lots of 


people do: 


= Emitters 


Dusi 


Fiarjuirarl 
apaw 

spawn FerUnit 
Lifetime 

Initial Size 
Initial Velocity 
Initial Rotation 
Size By Life 
Acceleration 
Sphere 


Initial Color 


Scale Color / Life 


BE B 


<. B <- 


BABAD 


GPU Sprites 
Farnier] 

spawn 

Lifetime 

Initial Size 

Initial Velocity 
Initial Rotation Rate 
Initial Rotation 
Cylinder (Seed) 


Const Acceleration 


A SDBBBB 


Mirs frani 


2B 


Mesh Data 

Fiara] 

spawn 

spawn PerUntt 
Lifetime 

Initial Size 

Initial Color 

Scale Color / Lite 
Emitter Initial Location 
World Offset 


Init Mesh Rotation 


Inherit Parent Velocity Hj (+ 


SS 8 


a aB 


GPU Sprites 
Fiarjuirarl 

opawn 

Lifetime 

Initial Size 

Initial Velocity 
Initial Rotation Rate 
Initial Rotation 
Cylinder (Seed) 


Const Acceleration 





TS | 


HS 


It contains a horizontal arrangement of all the emitters within the current particle 


system and, regardless of the amount of emitters you decided to go with, this 


horizontal list will keep expanding for you. 


Each column represents a single particle emitter, and each is made up of an emitter 
block at the top, followed by any number of module blocks, which are the parts used 
to depne the behavior and look of that emitter. 
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The emitter block at the top contains the basic properties of the emitter, such as the 
name, editor color, details amount, and the type of the emitter; is also used to quickly 
enable/ disable the emitter or even solo it to see it only at the viewport panel. The 
modules beneath it each control various aspects and behaviors of the particle 


Panicle Emier 


Lifetime 

Initial Size 
Initial Velocity 
Color Over Life 
Initial Rotation 
Sublmaqe Index 
Sphere 


Drag 


Size By Life 





Required, Spawn, Lifetime, Initial Size, Initial Velocity, Color Over Life, Initial 
Rotation, SubI mage Index, Sphere, Drag, and Size By Life are all modules that 
control the emitted particles’ behaviors. 


Each module has three major ways to be controlled: 


Å Click the module inside the emitter to highlight it, and then start changing its 
values from the D etails Panel. 


Å Click the checkbox at the module itself to enable or disable it quickly so you 
can get a better understanding of its effect over the whole emitter. 


Å Click the little graph icon at the right of each module to start controlling its 
value with a curve that you will be drawing inside the curve editor. As you 
can see, some of the modules have a colored strip at the far left (red or green); 
this tells us that the module already has a curve controlling it. 


Creating a particle emitter from scratch, not giving you an empty emitter as an 
expected behavior for a modular particle systems editor. But, in fact, a base emitter 
must have the raw modules that control its particles with minimal requirements. As 
everything here is up to you, those initial modules could be removed totally if you 
want. But...they are essential in most cases! 
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r P Er P ay : = Pr 
Friele spriirtar 


JEE 


i Required 


Spawn 
Lifetime 

Initial Size 
Initial Velocity 


Color Over Life 





But what if you want to add more modules? 


Well, adding modules will give you control over the behavior and þnal look of the 
emitter or particle system. So, by right-clicking at the top of the emitter top, you are 
going to display a huge context menu of modules provided by Epic. The emitter 
context menu includes some parameters related to the emitter itself, but most 
importantly it contains all the modules that could be used: 


Emitter 
Particle System 
TypeData 
Acceleration 
Attraction 
Camera 
Collision 
Color 

Event 

Kill 

Lifetime 

Light 
Location 
Orbit 
Orientation 
Parameter 
Rotation 
Rotation Rate 
Size 

Spawn 


SubUw 


Velocity 
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Now think about it like this: the modules are the main unit that builds the emitters 
(while the emitter itself is the main unit for building the whole particle system), and 
modules are used to control the various aspects of the particles that are released by 
an emitter. How simple now?! 


Once you realize the importance and the job of modules and emitters, you'll be able 
to build any system regardless of its complexity! 


There are different modules that can be added to the particle emitters. Those 
modules are broken up into various categories based on their usage. The supported 
categories are as follows: 


Å Acceleration: These modules control the particle acceleration effects, such as 
drag forces and constant acceleration force 


Attraction: These are modules which control particle movement by attracting 
particles to various points in space 


Camera: These modules control the motion of the particle according to the 
camera space 


Collision: These modules help you handle collisions between particles and 
geometries 


Color: These modules control the color of the particles 


Event: These modules control the triggering of particle events, which can in 
turn cause a variety of in-game responses 


Kill: These modules control particle destruction 
Lifetime: These modules control how long particles should live 
Light: These modules govern particle lights 


Location: These modules control where particles will be born relative to the 
location of the emitter actor 


Jo > To > To Joo > Jo Jo D> 


Orbit: These modules allow for screen-space orbital behavior to add extra 
motion to effects 
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Orientation: These modules allow for a rotational axis of the particles to 
be locked 


Parameter: These modules can be parameterized or controlled via external 
sources such as Blueprints and Matinee 


Rotation: These modules control rotation of particles 
R otationRate: These modules control the changes in rotation speed 
Size: These modules control the scale of particles 


Spawn: These modules add specialized particle soawn rates, such as 
Spawning particles per unit 


SubUV: These modules allow an animated sprite sheet to be displayed ona 
single particle 


Velocity: These modules control the velocity of each particle 


Those are all the categories that you can pnd inside the Cascade module's context 
menu; fee! free to start using the diffdent ones from each category in order to 
learn about the slight difference between them. Also, checking the particle system 
reference guide from Epic's homepage is a good way to learn about the pner 
differences between each module. 


The details panel 


This is just like any other details panel you could pnd around the different editors 
of the Engine. And as is the habit with all other Unreal Editors, by default, if you are 
not selecting any of the emitters inside the emitters list area, this panel will display 
the overall properties for the particle system itself. 
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But, as a sensitive window, it will automatically change its content and its set of 
options and parameters, based on your selection. Go ahead and try to select the 
emitter itself to see what it can display, or even try to select between the different 
modules, and you'll notice that it always changes its content and shows you different 
settings and parameters. Here is exactly where the majority of the magic happens. 
That is, adding the correct module for the required situation is the trick, but itis 
trickier when it comes to setting the parameters of the module itself: 


@) Details 


Search 


4 Particle System 


System Update Mode 
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Update Time FPS 
Warmup Time 
Warmup Tick Rate 
Orient ZAxis Toward Camera 
seconds Before Inactive 
a Thumbnail 
Thumbnail Warmup 
Use Realtime Thumbnail 
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> LODSettings 1 elements 
àa Bounds 
Use Fixed Relative Bounding Box 
> Fixed Relative Bounding Box 
4 Delay 
Delay 
Delay Low 
Use Delay Range 
4 Macro UV 
> Macro UVPosition 


Macro UVRadius 
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Now, after understanding how the details pane! works, let's start to breakdown 

all the parameters that you can pnd thereé almost all of them, starting with those 
related to the whole particle system, and then the ones relates to the particle emitter. 
The modules are different and the parameters for each are completely different, but 
there are a couple of attributes that are always the same within all the modules. 


Particle system 


A particle system is a complete particle effect made from one or more particle 
emitters. By allowing multiple emitters in the system, you'll be able to create particle 
effects that all belong to a single particle system. Then, you can use that particle 
system by spawning or inserting it into the level. 


A particle system contains the following public parameters: 


4 Particle System 


system Update Mode 


Update Time FPS 


Orient 7Axis Toward Camera [| 


| 60.0 a | 
Warmup Tick Rate 
‘0.0 A 


Seconds Before Inactive CC 





Å System Update M ode: This defines the method the particle system should 
use to update all its emitters: 


° Real-Time: This updates the emitters in real-time. 


° Fixed Time: This updates the emitters at a fixed time step. This will 
lock the system to the update time of the game and is performance- 
dependent. By setting the value of Update Time FPS, you'll be able 
to control it. A lower frame rate lowers the update time of the system, 
which means a slower particle system, while a higher frame rate 
speeds it up. Try not to use this method a lot; it is best used when 
the particle system should give a certain behavior that is tied with 
something else that could get slower or faster than the rest of the 
game, for example, tying the emitter to an animation clip! 


Å Update Time FPS: This is the time-step to use when operating in Fixed Time. 
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A Warmup Time: This is the amount of time to warm up the system at launch. 
It will allow you to set an emitter to start at its behavior peak. While it is very 
useful in multiple cases, it can also affect performance, so use it sparingly, 
especially at high values. It is there to be used with particle systems you want 
to have started while the map initially loads, like a fire that is already there. 


A Warmup Tick Rate: This controls the time step for each tick during system 
warmup (at the previous parameter). Increasing its value will improve the 
performance, and a value of 0 means the default tick time. 


Å Orient Z Axis Toward Camera: Setting it tot rue will force the local Z-axis of 
the particle system to be oriented towards the camera at all times. 


Å Seconds Before Inactive: This represents the number of seconds that, if the 
particle system is not rendered for it, it will go inactive and no longer be 
ticked. Using the value of 0.0 will prevent the system from ever being forced 
to be inactive: 


4 Particle System 


system Update Mode 


Update Time FPS 


Warmup Tick Rate 
Orient ZAxis Toward Camera 


Seconds Before Inactive LL) 





Thumbnail 


Thumbnail consists of the following parameters: 


A Thumbnail Warmup: The amount of time to warm up the system before 
capturing the thumbnail render when Use Realtime Thumbnail is checked. 


Å Use Realtime Thumbnail: If true, the thumbnail displayed in the content 
browser for theParticleSystemH asset will be automatically captured using 
the default camera position and reflect the current settings and appearance 
of the particle system instead of using the saved thumbnail. Using real-time 
thumbnail rendering can slow down the performance of the content browser: 


4 Thumbnail 


Thumbnail Warmup 


Use Realtime Thumbnail 
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LOD 


Here's what LOD consists of: 


A LODDistance Check Time: This is how often, in seconds, the particle system 
should perform a distance check to get the LOD level 


A LODMethod: This list contains options to define the method the system 
should utilize for selecting appropriate LOD levels: 


° Automatic: This sets the LOD level based on the LOD distance and 
checks the time automatically 


° Direct Set: The game will set the LOD level for the system to use 
directly 


° Activate Automatic: LOD level is determined at activation time, then 
left alone unless directly set by gameplay logic 


Å LODDistances: An array of distances you define in order to determine which 
LOD level to utilize while setting the LO D M ethod to Automatic 


Å LOD Settings: An array of values to determine a few settings to use for each 
individual LOD: 


4LOD 
LODDistance Check Time 0.25 ‘i 


b LODDistances 1 elements 





> LODSettings lelements * Qj 


Bounds 
Bounds consist of the following parameters: 


Å Use Fixed Relative Bounding Box: If true, the logic will utilize Fixed 
Relative Bounding Box as the bounds for the particle system. 
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Å Fixed Relative Bounding Box: This allows you to set bounding boxes for 
the particle system. This is a good choice to make in order to reduce the 
overhead of performance while performing bounds updating each frame. 
You might need to right-click on the Toggle Bounds button on the toolbar 
and fill in this dialog box with the currently-used values of the dynamic box 
in Cascade; that will give you some values that you can use to start tweaking 
your Min and M ax values in Fixed Relative Bounding Box: 


a Bounds 
Use Fixed Relative Bounding Box [| 


a Fixed Relative Bounding Box 


> Min 





Delay 
Within this section of parameters, you can set some custom timing values to 
control particles: 


Å Delay: The amount of time in seconds the particle system should wait before 
it gets active. It also reoresents the highest value of the range to use for 
choosing a random delay value when the Use D elay Range option is active 


Å Delay Low: The lowest value of the range to use for choosing a random 
delay value when Use Delay Range is active. 


Å Use Delay Range: If true, a random value between Delay Low and Delay is 
chosen for the actual delay value to use: 


4 Delay 


Delay 
Delay Low 


Use Delay Range 





Macro UV 


Using the M acro UV section, you can set more details for the particles' UV texturing: 


A Macro UVPosition: The local-space position relative to the particle system 
used as the center point to generate the UV texture coordinates for the 
Particl eMacroUV material expression. 


[ 164 ] 


Chapter 6 


A Macro UVRadius: The world-space radius that determines the distance from 
the macro UV position where the UV texture coordinates generated for the 
ParticleMacroUV material expression will begin tiling: 


d Macro UV 


b Macro UVPosition 


Macro UVRadius 





Occlusion 
Sometimes it is necessary to make sure particles that are out of the bounds get 
occluded, and within this section you can set the parameters for occluding particles: 
A Occlusion Bounds Method: The method to use when calculating the 
occlusion of the particle system: 
° None: Occlusion is not calculated for the particle system 


° Particle Bounds: The bounds of Particl eSystemComponent are used 
for calculating occlusion for the particle system 


° Custom Bounds: Custom Occlusion Bounds (the coming value) 
values are used to calculate occlusion for the particle system 


A Custom Occlusion Bounds: The bounds to use for calculating occlusion 
when using the Custom Bounds occlusion bounds method: 


4 Occlusion 


Occlusion Bounds Method 
4 Custom Occlusion Bounds 
b Min 


b Max 
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Materials 
Here you can set an array of the materials used for particles. 
A Named Materials Slots: An array of named material slots to be used by the 


emitters of this particle system. An emitter can use this array of materials 
rather than its own material: 


4 Materials 





Named Material Slots Oelements * Qj 


The particle emitter 


A particle emitter is the unit used to build a particle system. The particle emitter 
contains the following parameters. 


Particle 


Here we list the settings that you can set for each particle. Be aware that changing 
some values here might have an effect on performance: 


4 Particle 
Emitter Name 


Initial Allocation Count 


Quality Level Spawn Rate Scale 


Detail Mode 


Disabled LODs Keep Emitter Alive 





Å Emitter Name: The name of the emitter. 


Å Initial Allocation Count: This value allows you to declare the number of 
particles that should be allocated at initialization of the emitter. If it is 0, 
the calculated peak count Is used. 


A Quality Level Spawn Rate Scale: You can use this value to scale down 
the spawn rate of the emitter when the engine is running in the M edium 
or Low detail mode. It could be used to optimize the particle draw cost in 
split-screen mode. 
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Å Detail M ode: Choose a detail mode to be applied; the Low option will cause 
give better performance; you've spawned several clones of the particle 
system, while the High detailed mode will cause more performance hits. 
The three modes are as follows: 


° Low 
° Medium 
° High 


Å Disabled LODs Keep Emitter Alive: Set it tot rue if your current LOD 
is disabled and you want the emitter to be kept alive and not considered 
as completed. 


4 Particle 
Emitter Name 


Initial Allocation Count 


Quality Level Spawn Rate Scale 


Detail Mode 


Disabled LODs Keep Emitter Alive 





Cascade 


Here you can pnd a few options, mostly used for display mode within the particle 
editor itself (Cascade). If you have lots of particle emitters within one particle system, 
it will be easier to differentiate them by colors depned in this section: 


Å Emitter Render M ode: The method to use when rendering the emitter's 
particles: 
° Normal: This renders the emitter's particles as intended 


° Point: This renders the emitter's particles as a 2x2 pixel block 
without scaling 


° Cross: This renders the emitter's particles as a cross of lines 
° None: The emitter's particles are not rendered 
Å Emitter Editor Color: The color of the particle emitter block when collapsed 


in the curve editor and debug rendering modes, as well as the strips at the 
emitter's title when it is not collapsed. 
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Å Collapsed: Set tot rue in order to collapse the particle emitter in the Emitter 
List in the editor. Double-clicking on the particle emitter block gives the 
same result: 


4 Cascade 


Emitter Render Mode 


a Emitter Editor Color 


Collapsed 





Particle modules 


A particle module is the base of all modules (regardless of the type or functionality, 
each module has its own parameter list and the Cascade parameter list). This means 
that all modules will contain the following properties. 


Cascade 
This contains the following options: 
A 3D Draw Mode: If true, any 3D visualization helpers for the module, for 


example, wireframe geometry depicting the extent of an Initial Location 
module, will be displayed. 


A Module Editor Color: This is the color the module will utilize in the graph 
editor: 


4 Cascade 


B 3D0raw Mode 


4 Module Editor Color 
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Curve Editor 


To be honest with you, creating particles, or anything with a constant value, has 
always been tedious. But things started to change when the concept of curve editors 
and curve-based values came into the process. 


Now it's different, and rather than saying the X value is going to be 1 all the time, 
you can say that the X value is going to start at 0.5 and reach 1.0 by the end of the 
lifespan of that particle; this could have a huge impact on behaviors! 


One of the most powerful features of the Cascade Editor is the typical Unreal Editor 
Curve Editor panel (like the one used in Matinee Editor). At prst glance, you might 

think it is not the proper place to have a Curve Editor! But once you know why it is 

there and how to useit, you'll depnitely appreciate its existence: 





The curve pane! allows you to adjust any of the module values that need to be 
changed along the life of a particle, or even along the whole life of an emitter. 
With this, you'll be able to have two types of values: 


Å Constant vales that will never be changed 
Å Dynamic values that always change over time 
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Any module property could be editable within the curve inside the curve editor, but 
the only condition is that the property must have a distribution type that can utilize 
a curve. A distribution type such as D istributionFLoatC onstantC urve is used to 
control yoat values. As you can seein the preceding screenshot, the Curve Editor is 
simply divided into three main areas: 


Å Toolbar: A bar full of buttons that give you easy access to the important 
functionalities needed while drawing curves: 


ea NZ N —] | Sek Ft Ww 7" J9 Current Tab: 





z. a . H 
o  Auto/Clamped User Break Linear Constant Flatten Straighten ShowAll Create Delete Default Xa 


° Horizontal: Horizontally fits the graph view to the current visible 
tracks 


° Vertical: Vertically fits the graph view to the current visible tracks 


° All: Fits the graph horizontally and vertically to the current visible 
tracks 


° Selected: Fits the graph horizontally and vertically to the selected 
points of the current visible tracks 


° Pan: Switches the Curve Editor into the Pan and Edit modes 
° Zoom: Switches the Curve Editor into the Zoom mode 


° Auto: Sets InterpM ode (interpolation mode) for selected keys to the 
Auto-curve mode 


° Auto/Clamped: Sets InterpM ode for selected keys to the Auto-curve 
mode 


° User: Sets InterpM ode for selected keys to the User curve mode 
(user-modified tangents) 


° Break: Sets InterpM ode for selected keys to the Curve Break mode 
° Linear: Sets InterpM ode for selected keys to the Linear mode 

° Constant: Sets InterpM ode for selected keys to the Constant mode 

° — Flatten: Set selected keys/ points tangents to be flattened horizontally 
° Straighten: Straightens selected keys/ point tangents, if it was broken 
° Show All: Turn on/ off the display of all key tangents 
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° Create: Creates a new tab 
° Delete: Deletes the current tab 


° Current Tab: Allows you to choose the current tab if you've created 
multiple tabs 


Å Track List: A list of all the tracks you have within a particle system (In short 
list of the modules that is using curves to control its parameters): 
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This is the list where you find all of the curves currently loaded into the 
current tab. Each track in the track list has a name, representing the name 
of the property associated with the track. Also, each track in the list has a 
visibility switch button for each curve in the track and an overall visibility 
switch button to turn on/ off all of the subtracks. In order to remove a track 
from the list, the easiest way is by right-clicking on a track in the track list; 
this will trigger the track list context menu, which has only two options: 


Remove Curve 


Remove All Curves 





° Remove Curve: Removes the current track from the Curve Editor 


° Remove All Curves: Clears all tracks loaded in the curve editor from 
all tabs 
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Å Graph: The vast area with a vertical (value) and horizontal (time) axis on 
which to draw all your curves: 


-1000.00 


-2000.)0 
-3000.)0 
-4000.)0 


-5000.00 
-2.00 





It is the most important and unimportant part of the curve editor pane! It 
sounds contradictory, but it is the truth. You can make an amazing particle 
system using Cascade without using graphs made by the curve editor at all, 
and it will still look amazing. But, at the same time, you might not be able to 
do anything without graphs! It deoends on the visual look you are seeking, 
the game look, and the amount of complexity the particle system should have. 


This area is a just a straightforward graphical representation of the value 
(the vertical axis) over time (the horizontal axis). The main unit that makes a 
curve Is the keys; if you have one key only, then you don't havea curve, but 
if you have morethan one key, then you havea curve. Keys are displayed 
as points (that is the reason you find me sometimes calling them keys, while 
at others calling them points), which can be selected and manipulated to 
visually edit the curve. Those keys could have different interpolation modes 
applied in order to directly change the key look, which will change the way 
that a key will lead on to the following one. 


Right-clicking on the graph brings up the graph-sensitive context menu. 
While clicking on an empty area gives a general option on the context menu, 
clicking over a key/ point will give you a whole different context menu. 
Right-clicking on empty space will display the following: 


n r ae 
n ri cee 
to | Lal | 


Scale All Times 


Scale All Values 





° Scale All Times: Scales the time values (horizontally) of all points on 
all visible tracks 
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° Scale All Values: Scales the values (vertically) of all points on all 
visible tracks 


Right-clicking over a key will display the following: 


Set Time 


Set Value 





Delete Key 


° Set Time: Manually sets the time of the key 
° Set Value: Manually sets the value of the key 
° Delete Key: Deletes the selected key/ keys 


Interpolation modes 

The interpolation mode buttons control the applied interpolation method that will 
be used at the curve point in order to allow a key on the curve to use that method 

to reach the next key. Some of these modes are a one constant result method, while 
others could be adjusted more freely. Methods such asBreak,Auto, and User, will 
produce white handles for you; you can use those handles to take more control over 
the resulting curve between keys. The different interpolation modes supported by 
Unreal are as follows: 


Å Auto: Unreal will automatically define the interpolation between the keys 
and this might cause undesired behaviors: 


-1000.00 


-] 500.00 





-0.50 
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Å Auto Clamped: The clamped are usually the best fit for you; it does a smooth 
interpolation between keys, while keeping things logical. For example, when 
you've two keys sharing the same value but at different times, the blend 
between both keys will be smooth without changing in values, which is 
missing in the Auto Clamped mode: 


-1000.00 


-1500.00 





Å User: This mode gives you the opportunity to adjust the look and feel of each 
key and curve: 


-1000.00 


-1500.00 
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Å Break: This modeis very special and extremely popular with lots of 3D 
packages. This mode will break each key into two separate handles; you can 
control each independently, and it is very good in the case of bouncy curves: 


-1000.00 


-1500.00 





-0.50 0.00 


Å Linear: This is one of the most used modes; the movements between keys are 
not smoothed at all, which means there isn't any type of ease in or out, and 
the interpolation will always be at one speed: 
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Å Constant: This mode is mostly known as "Stepped" mode within the 
interpolation curve world. As you can seein the following screenshot, the 
interpolation just occurs at one frame, which means there isn't any type of 
interpolation at all, neither smooth nor linear. It is snappy: 


-1000.00 


-1500.00 





Organizing curves 


We mentioned the importance of curves earlier in this chapter, and how they make 
results way more different and acceptable. But how could we force a value to use a 
curve rather than a constant value? 


A few pages ago, while breaking down the emitter itself, and how it is constructed, 
we mentioned that there is a small button within each module that can make it 
controllable via curves. 


This means that, to add a certain module to the curve editor, you just need to click on 
that green little box with a curve that appears on the far-left side of the module Itself. 
This will produce a colored curve directly on the curve editor; you can remove it by 
simply pressing the button again. 


Keep in mind that the color that is used to draw the curve is a randomly generated 
color, but you still can change it by selecting the module and editing its color from 
the Details panel, which is good for organizing stuff. Personally, | like to tag my 
curves in order to facilitate looking around them when things get more crowded! 


a 
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Adding curves to the graph 


Adding acurveisas simple as clicking on the previously mentioned curve icon in 
an emitter module; this will send any available curves for that module down to the 
curve editor. 


Removing curves from the graph 


In order to remove curves from the graph once you are done editing them, you just 
need to right-click over the block for the curve in the curve editor list, and choose 
Remove Curve from the context menu. 


Organizing the curve editor with tabs 


| have mentioned that we can change the colors of graphs in order to make things 
more organized. But that's not everything. The colors trick is good to differentiate 
between the different curves based on their goals. But what if you have to organize 
hundreds of curves? 


There is more when it comes to being tidy here! 


Have you ever thought about having around a hundred tracks inside one particle 
system that is made up of multiple emitters? Yes, it is possible, and in some cases, 
with the most complex systems, you might need to go beyond the þrst hundred. In 
that case, you can start adding tabs, which are mostly described as folders! 


Just like adding folders inside the scene hierarchy in order to organize it, here you 
can add tabs as folders to include as many curves as you wish, and then givea 
general name for the tab. 


Creating a new tab is easy; it can be created by pressing the toolbar shortcut button. 
Tabs can even be deleted with another shortcut button: 


y" J" Current Tab: 


Create Delete 
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Spawning particles 


Now Tabs ended up with particle system assets, basically inside the content 
browser—just an asset within a folder. But how can these be used inside the 
game or the map itself? 


Well, when it comes to the usability, Unreal is the master, and as with anything else 
within Unreal Engine/ Editor, there are various ways to help you achieve your goals. 
These are common and yet known methods that you can follow in order to use any 
particle system you have made: 


Å Drag and drop: This is the most common method, where you just drag the 
Particle System asset from the content browser, and drop it inside the map. 
But this method only comes into use when you are building the level, and 
you need to put some particles there by default, for example, when you need 
to put some fires around It. 


Å Animation notifications: This one of my favorite methods, as when we used 
it to call logic through notifications before, while building enemies and 
the player; the same approach could be applied here as well, and tn fact 
the notifications menu has an option to spawn a particle. | usually use this 
method when the animation needs to be perfectly timed with the animations, 
something like footsteps, for example. J ust choose the custom option called 
PlayParticleEffect: 


| lie | || 
WOUTY 


Add Notify State.. + PlaySound 

Manage Notifies... Custom 
OnPrepareAttack 
OnEndAttack 


New Notify 





After that, and once you have the notification added to the animation 
timeline, you can select the notification, and that will open lots of parameters 
that you can set at the D etails panel, not limited to but including the particle 
system itself: 
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4 Anim Notify 
Notify 


PSTemplate 


socket Name 

Attached 
> Location Offset 
> Notify Color p} 





Å Blueprint nodes: The other common method of spawning particles at runtime 
is by using a blueprint node. With the same approach you use for your 
gameplay logic, at any certain moment where you need to spawn a particle 
system, you can either call the Spawn Emitter at Location node, or Spawn 
Emitter Attached: 


F Spawn Emitter at Location [| F Spawn Emitter Attached 


Emitter Template Return Value Emitter Temp late Return Value 


= n" A = om, 2, 
SeIeCT ASSP. Select ASSET 


Location Attach to Component 

> had 
[x 0.0][y o.0][Z 0.0] j —e 
©» Attach Point Name | None | 


Rotation 
i Location 


x 0.0][¥ 0.0] [2 0.0] 


x 0.0][¥ 0.0] [2 0.0] > | 


Auto Destroy BA _ Rotation 
x 0.0][y 0.0][2 0.0] 


Location Type 
Keep Relative Offset = 


Auto Destroy RA 
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A C+t+logic: As always, while there are methods to be followed in Blueprint, 
there must be methods to be followed with C++ code. At the end of the day, 
Blueprint logic is a visual form of the C++logic. At any moment you need 
to write a magical line that spawns particles for you, you just either call the 
method UGamepl ayStatics::SpawnEmitterAtLocation or the method UG 
amepl ayStatics::SpawnEmitterAtt ached, which are basically just the 
equivalent of the blueprint nodes: 


UFUNCTION( BlueprintCallable, Category="Effects| Components] Particle 
System", 
Meta=(Keywords="particle system", Worl dContext="WorldCon 

textObject", UnsafeDuringActorConstruction="true")) 
static UParticleSystemComponent * SpawnEmitterAtLocation 
( 

UObj ect * Worl dContext Obj ect, 

class UParticleSystem * EmitterTempl ate, 

FVector Location, 

FRotator Rotation, 

bool bAutoDestroy 
Static UParticleSystemComponent * SpawnEmitterAttached 
| 

class UParticleSystem * EmitterTemplate, 

class USceneComponent * AttachToComponent, 

FName AttachPoint Name, 

FVector Location, 

FRotator Rotation, 

EAttachLocation:: Type LocationType, 

bool bAutoDestroy 


Changing parameters at runtime 


Sometimes a game forces you into strange situations. One of the situations | can 
remember in a game is when we needed to change the particle system color to match 
a certain color the player had collected. In such a case, it was not possible to depne 

a color previously, and the particle system needed to be yexible enough to match 
the color the player already had, keeping in mind that every time the scenario is 
different and the player holds a different color. 
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Such a situation normally is not easy, but thankfully, with Unreal Engine, you can 
depne the parameters that you might need to change at runtime. Then, changing its 
value is a matter of setting anew value to the tagged parameter. But how? 


l. 


3. 


4. 


First you need to decide which value is going to be changed, and let's say | 
need to change the main color of the particle system. So, you simply go to the 
targeted module and to the desired value, and set its Distribution value to 
Distribution V ector Particle Parameter. 


Now you need to give a name to the parameter, in the Parameter N ame þad. 
In my case, thisist heCol or Parameter Runti me: 


a Color 


4 Color Over Life 


4 Distribution Distribution Vector Particle Parameter w 
Parameter Name ‘theColorParameterRuntime — 





This given name is very important, as you are going to access the value using 
this name through the logic. 


Now within the logic, once you havea reference to the particle, you can 
simply call a node such asSet Col or Par amat er , in order to set the value, 
and don't forget to write down the parameter name: 


Target Particle System Component 


ditt ll 
: NewParticleSystem 


5. 





J Set Color Parameter 


Target 


- Parameter Name 
| theColorParameterRuntime | 


Param 


Keep in mind, | used the Set C olor Parameter node, because the value | 
wanted to change was a color, but sometimes you need to change af | oat or 
i nt value, and there are plenty of those set nodes to serve the desired goal. 
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Summary 


Congratulations, you have now got to grips with one of the most important and core 
parts that make Unreal an Unreal Engine. It is not only because of the importance 

of particles to the game's þnal look, but also because tons of artists and developers 
move into Unreal Engine, just for the sake of its powerful particle workyow. It is the 
best place to showcase a demo of 3D content! 


You went through the particles editor step by step and understood all its sections, 
how to use each of them, and, most importantly, what each part is responsible for. 


A particle system is an asset that is made out of several (or only one) particle 
emitters, and you've learned how to build any type of system you want. 


A particle system asset is just another asset within the editor; you can have it already 
inside your maps, but it is more common to spawn it at runtime, and you have 
understood the several ways that you can use to spawn a particle at runtime. The 
engine provides more than one method, and you have to pick the one that is most 
btting for the situation! 


Sometimes, particles look better when you change them at runtime, and sometimes 
the story itself forces you to do that. You have just learned how to control any 
parameter at runtime, not only that, but also how to add an animation curve to 
support any value or parameter for the particle system. 


Now | would recommend you go ahead inside your game sample, play it a couple 

of times, and try to notice what is going to familiarize yourself with particles. Come 
up with alist of required particles, and soend some time making them real, and most 
importantly, connect them after that with your game logic. 


Once you are done, go ahead to the next chapter, and let's add some visual appeal to 
the pnal look of our map! 
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Sometimes, building the game world and throwing some light sources in an artistic 
way is not enough to visualize the game world, and not even enough to support the 
game story. 


As you know, working in a movie comes to a lot of editing, mostly in computers, 
using applications such as Adobe After Effects or Nuke. Using those apps has 
become essential for any media, as you can add some effects on the resulting 
movie or clip that lead to a huge dramatic effect and feel for the audience. 


Games, as well, are a type of media, and games too can tell a story; even if the game 
has no story, the overall mode of the game can tell its own story. Color effects, or old 
screen effects using blur or such, and tons of other effects, can all deliver the content 
in a most appealing way. 


And that's what we are going to do next. We are going to focus on the details of 
applying post processing effects and mastering the usage of the post processing 
volumes. We will also be looking into making lightmaps, in order to get the best 
out of lighting. 


By the end of this chapter you'll be able to do the following: 


Å Createa friendly lightmaps environment 

Bake the lightmaps for better performance 

Understand the usage of the post processing volumes 

Master all the different post processing effects available within Unreal 


> To > To 


Use the reflection probes to enhance the reality of the levels 
Å Master the fog effects, and use them if needed 


With all of this eye candy content are set in place, let's get started: open your game 
sample, and let's make it simply stunning! 
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The lightmass 


Yes, you didn't read it wrong! Lightmass is the name Unreal engine usually gives 
to the term lightmaps. When it comes to baking the light data into maps (the 
lightmaps/ lightmass), Unreal Engine has within its rendering toolset: the ability to 
bake the light data into this type of maps. These maps will be used later at runtime 
to light the level. The lightmass builds the lightmaps for the stationary light sources 
and the static light sources only. 


And it is obviously clear why it does not supporting the dynamic (moveable) lights, 
as this type of lights can't be precomputed by any means. 


The Swarm Agent 


The process of building lightmaps is an automated one, which means there Is 

no speciþc length of time that it will take. Based on your map or game and its 
complexity, building lightmaps could take too much time and performance from 
the machine. 


But Unreal Engine Is full of supporting tools that are built in such a way as to 
serve you by saving time and delivering the best content. There is a small C#tool 
that is connected to the Unreal editor, which plays the role of manager to handle 
the communications between the lightmass and the editor. That manager is called 
Swarm Agent. 


Swarm Agent is autopred in order to perform its job and stay minimized (this means 
that you don't have to manually run it from somewhere); it was written to know the 
time that it has to start and pnish its job and then shut down: 
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K3 Swarm Agent 


File Edit Cache Network Help 
Log Swarm Status | Settings | 
Machine 


DCORNISH-X-30 
BUILDFARM-03 
BUILDFARM-04 
BUILDFARM-05 
BUILDFARM-06 
BUILDFARM-08 
BUILDFARM-11 
BUILDFARM-12 
BUILDFARM-13 
BUILDFARM-15 
BUILDFARM-18 
BUILDFARM-19 
BUILDFARM-20 
BUILDFARM-21 


BUILDFARM-22 


Distributed Progress 


Key 
[| Exporting scene C] Lightmass Starting A Emitting Photons C] Collecting Photons m Processing Mappings 





For more information about Swarm Agent, you can check the Unreal Engine 3 UDN 
documentation site,http://udn. epicgames. com/Three/ Swarm. ht ml , as Swarm 
was not well covered within Unreal Engine 4 now! 


The ambient occlusion 


We usually call the indirect shadow ambient occlusion. When lightmass gets built, 
it calculates the ambient occlusion (AO for short from now on). 


Lightmass works by calculating AO, and then applying it to direct and indirect 
illumination, and pnally baking it into lightmaps. The AO is enabled by default, 
but you can still disable it for your own artistic goals. Disabling it is very easy: you 
need to uncheck the checkbox Use Ambient Occlusion in Lightmass Settings of 
the Lightmass tab within World Settings: 





Use Ambient Occlusion 


Enhandng theVisual Quality 


Don't forget that you have to rebuild the lightmass in order to update it to the latest 
conbgurations you have changed (just hit the Rebuild button at the mid-top of the 
editor). A scene without AO really looks too different and less live than a scene with 
AO. You can check the difference between the following two images; while the prst 
has the AO disabled, the second one has it enabled (check the edges’ and corners’ 
indirect shadowing): 

















That's how it will look when it is enabled. While those are just simple primitives, 
the shadowing around the corners, edges, and contact points makes them more 
acceptable and believable. 























But as always, life is not a fairytale, and while there are advantages to something, 
there must be some disadvantages. The one and only disadvantage of AO is that it 
requires a high resolution light map in order to look as expected, and it never looks 
as expected as long as the quality setting is set to Preview Quality. 
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AO settings 

For some people, AO is just an option to enable, and this is partly true. But 
sometimes, even enabling it will not give you the desired look, and then you 

have to start adjusting and tweaking some values to achieve the best visual pdelity: 


A 
A 


Use Ambient Occlusion: Enables and disables the feature. 


Visualize Ambient Occlusion: This is useful for seeing exactly what occlusion 
changes you made and comparing the effects of different settings as it works 
by overriding the lightmaps. 

M ax Occlusion Distance: Maximum distance for an object to cause occlusion 
on another object. 


Fully Occluded Samples Fraction: Fraction of samples taken that must be 
occluded in order to reach full occlusion. N ote that there is also a per-primitive 
Fully Occluded Samples Fraction, which allows control over how much 
occlusion an object causes on other objects. 


Occlusion Exponent: Higher exponents Increase contrast. 


4 Lightmass 


a Lightmass Settings 


| Use Ambient Occlusion 


Occlusion Exponent 
Fully Occluded Samples Frac 


Max Occlusion Distance 200.0 


* 
| Visualize Ambient Occlusion i 
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Lightmass settings 


In order to get full control over Lightmass's bnal results, Unreal Engine gives you 
lots of attributes that you can adjust. Unfortunately, not all of them arein one place 
and they are scattered around the editor, which means there isn't one panel where 
you can adjust all the parameters related to Lightmass, and that is due to the wide 
modularity of the engine. 


So if you are going to use Lightmass (which everyone does nowadays), you will need 
to adjust the settings for the level itself, as well as meshes, brushes, materials, light 
sources, and þnally, the Lightmass Importance V olume value. 


World Settings 


The global Lightmass settings can be found under the World Settings window, 
within the Lightmass section: 


4 Lightmass 

4 Lightmass Settings 
Static Lighting Level Scale 
Num Indirect Lighting Boune 
Indirect Lighting Quality 
Indirect Lighting Smoothnes: 

> Environment Color 

Environment Intensity 
Diffuse Boost 
Use Ambient Occlusion 
Direct Illumination Occlusior 
Indirect Illumination Occlusit 
Occlusion Exponent 
Fully Occluded Samples Frat 
Max Occlusion Distance 


Visualize Material Diffuse 


Visualize Ambient Occlusion B 


Volume Light Sample Placen 


Compress Lightmaps 


Level Lighting Quality 


> Lightmaps 10 Lightmap(s) 


Packed Light and Shadow Map| 1 02-4 a” 


Force No Precomputed Lightin o] 
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The various settings are as follows: 


Å Static Lighting Level Scale: While one Unreal Unit =1 cm, this value 
represents the scale of the leva relative to the scale of the engine. It is usually 
used to decide how much detail to calculate in the lighting. Logically, the 
smaller scales will increase build times. 


A Num Indirect Lighting Bounces: The number of times light is allowed 
to bounce off surfaces, starting from the light source, with 0 being direct 
lighting only, and 1 being one bounce. 


Å Indirect Lighting Quality: This scales the sample counts used by the 
Lightmass GI solver. Higher settings result in fewer solver artifacts 
but longer build times. 


Å Indirect Lighting Smoothness: The higher the values, the more smoothing 
will be applied, which can hide solver noise but also causes detailed indirect 
Shadows and AO to be lost. 


Å Environment Color: Color that rays which miss the scene will pick up. 


Å Environment Intensity: Scales the previous value to allow an HDR 
environment coloring. 


Å Diffuse Boost: Scales the diffuse contribution of all materials in the scene. 
Increasing Diffuse Boost is an effective way to increase the intensity of the 
indirect lighting in a scene. The diffuse term is clamped to 1.0 in brightness 
after Diffuse Boost is applied, in order to conserve the material energy 
(meaning light must decrease on each bounce, not increase). If raising the 
diffuse boost does not result in brighter indirect lighting, the diffuse term 
is being "clamped", and the light's Indirect Lighting Scale value should be 
used to increase indirect lighting instead. 


Use Ambient Occlusion: Enables static AO. 


Direct Illumination Occlusion Fraction: How much of the AO to apply 
to direct lighting. 


Indirect Illumination Occlusion Fraction: How much of the AO to apply 
to indirect lighting. 


Occlusion Exponent: Higher exponents Increase contrast. 


Fully Occluded Samples Fraction: The fraction of samples taken that must 
be occluded in order to reach full occlusion. 


Jo Joo > D> > > 


M ax Occlusion Distance: The maximum distance for an object to cause 
occlusion on another object. 
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Å Visualize M aterial Diffuse: Override normal direct and indirect lighting 
with just the material diffuse term exported to lightmass. This is useful 
when verifying that the exported material diffuse matches up with the 
actual diffuse. 


Å Visualize Ambient Occlusion: As discussed earlier, this is useful for seeing 
exactly what occlusion changes you made and comparing the effects of 
different settings, as it works by overriding the lightmaps. 


A Volume Light Sample Placement Scale: While volume light samples are 
computed via the lightmass, that value will scale the distances at which 
volume lighting samples are placed. Using the larger scales will end up 
with fewer samples and less memory usage, and will reduce the indirect 
lighting cache update time. 


A Compress Lightmaps: Enable or disable the texture compression. Disabling 
this will result in an increase of memory size and disk size, and will also 
produces a tidier texture with fewer artifacts. 


Level Lighting Quality: This reflects the current level's lighting build 
quality settings. 


Lightmaps: The list of Lightmaps textures. 


Packed Light and Shadow M ap Texture Size: The maximum size for the 
packed light textures and the shadow maps. 


Jo Joo To Jo 


Force No Precomputed Lighting: Allows you to force the lightmaps and the 
other precomputed lighting to not be created even when the engine thinks 
they are needed. It is a useful choice for improving the iteration in level with 
fully dynamic lighting and shadowing. 


Importance volume settings 

Lots of your level parts are mostly there for the sake of having them; some parts are 
not visible to the player at all, while other parts are visible but are either unreachable 
(such as distant mountains, for example), or are not playable elements in interaction 
with the player. 
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Only the actual playable area needs high-quality lighting. While the lightmass emits 
photons based on the size of the level, the background and unused objects and 
meshes will be there just to increase the number of photons that need to be emitted! 
That will end up in higher lighting building time. 


H ere comes one of the most outstanding tools within Unreal Engine, Lightmass 
Importance Volume, which is meant to control the area that lightmass emits 
photons in, and allows you to concentrate the lightmass efforts. Any area outside 
the Importance Volume gets only a lower quality one bounce of indirect lighting. 


As you can see this is a map of Bellz. At the prst image you see the size of the 
full map, but actually what the player needs is the central part, which is in the 
second image. 
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But while the focus area of the gameplay is alot smaller, and centered in the middle 
of the map, there are lots of decorative assets far away, and background elements 
that the player will never reach. We have to put the Importance Area on the area 

of focus. 





Adding the Importance Volume to the level is done the same way you add any other 
volumes. You just drag and drop them into the level, and you just need to know 
where to pnd them inside the M odes panel. 


Search Classes 
Recently Placed > 

wf Lightmass Importance Volume 
Basic 


+ 
Lights Nav Mesh Bounds Volume 
Visual Effects è 

Nav Modifier Volume 
BSP 
Volumes Pain Causing Volume 
All Classes 

Physics Volume 


Post Process Volume 


= Precomputed Visibility Override Volu 





= gin 
a Precomputed Visibility Volume 
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This ts not the only way you can do that; actually, any brush shape within Unreal 
Engine could be used as an Importance Volume. You just need to convert the brush 
into the Lightmass I mportance V olume, by selecting the actor and choosing the type 


of actor to be converted: 


4 Actor 
select a Type 
Can be Damaged 


Initial Life Span 


select a Type ¥ 


¥ 





Then select the proper type from the list. This method is not only used to convert 


brushes into Lightmass Importance Volume, it could also be used to convert a 


brush into any of the types listed in the drop-down list. We used it alot in Chapter 3, 
Designing Y our Playground, while building the playground: 


4 Actor 
Select a Type 
Can be Damaged 


Initial Life Span 


Select a Type. 


Search 


AudioVolume 


D BlockingVolume 

ty CameraBlockingVolume 
* CullDistanceVolume 
 Kill7Volume 

= LevelStreamingVolume 


$: LightmassCharacterindirectDetailVolume 


NavMeshBoundsVolume 
NavModifierVolume 
PainCausingVolume 
PhysicsVolume 
PostProcessVolume 


em PrecomputedVisibilittyOverrideVolume 
cœ PrecomputedVisibilityVolume 
® TriggerVolume 
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Once you've inserted the light source into the map, on selecting it, you have access to 
all its attributes and parameters within the D etails panel. This set of settings not only 
indicates the light color and look, but also some Lightmass options related to the 
light shape itself: 


Å Light Shape Settings: Any light source that could be found within the 
Unreal Editor has some lightmass parameters that are listed inside the 
Lightmass section within its Details panal: 


a Lightmass 


Light Source Angle 
Indirect Lighting Saturation 


Shadow Exponent 





This consists of the following: 


° Light Source Angle: Determines the angle that the light's emissive 
surface extends relative to a receiver (but only for directional 
light sources) 


° Indirect Lighting Saturation: A value of 0 will result in indirect 
lighting being completely de-saturated; 1 will be unchanged 


° Shadow Exponent: Controls how fast areas change from fully lit to 
fully shadowed, or in a more technical sense, it controls the shadow 
penumbras falloff value 


Å Material Settings: Even a material asset has its own Lightmass Settings to 
be adjusted. To access them, you have to double-click the material in order to 
open it inside the M aterial Editor, then select the base node of the material, 
and finally find Lightmass Settings under the Lightmass section of the 
details panel: 


4 Lightmass 


a Lightmass Settings 


Cast Shadow as Maski F 


Diffuse Boost 


Export Resolution Scal WA! 





These settings consist of the following parameters: 


° Cast Shadow as M asked: Works with the translucent materials, as 
it is meant to treat the material as if it is masked for the purposes of 
Shadow casting! 
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Diffuse Boost: Scales up the diffuse contribution of this material to 
the static lighting 


Export Resolution Scale: If you needed to add more details to a 
surface using this material, then scaling up this value will scale up 
the resolution that this material's attributes are exported at 


Å Brush Settings: After adding a brush, you might need to apply some changes 
to it in order to be able to see its Lightmass Settings inside the D etails pane’: 


Lighting: 
Lightmap Resolution: OO = 
a Lightmass 
a Lightmass Settings 
Use Two Sided Lighting | E 
Shadow Indirect Only a 


Use Emissive for Static | a 


Diffuse Boost 1.0 


Fully Occluded Samples| ENL 





These settings consist of the following: 


fe} 


fe} 


Lightmap Resolution: The resolution of the lightmap. 


Use Two Sided Lighting: Setting it to true makes this object lit as 
if it receives light from both sides of its polygons. 


Shadow Indirect Only: If checked, this object will only shadow 
indirect lighting. This is useful for grass, since the geometry that is 
rendered is just a reoresentation of the actual geometry and does not 
necessarily cast accurately shaped shadows. It is also useful for grass 
because the resulting shadows would be too high frequency to be 
stored in precomputed lightmaps. 


Use Emissive for Static Lighting: Setting this tot rue will allow you 
to use the emissive for static lighting. 


Diffuse Boost: Scales the diffusion of all materials applied to 
this brush. 


Fully Occluded Samples Fraction: This value allows you to control 
how much occlusion an object causes on other objects. 
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The post process project settings 


Remember in Chapter 1, Preparing for a Big Project, while we were setting up the 
project and setting some of the major settings there, there were some parts that 
we left to be changed later, such as the post processing settings. Now itis time 
to change them. 


As Unreal Engine was designed to give the best quality ever, there are already- 
activated post processing effects that your game’ project will have by default, 
and you will be able to get their results inside your editor window while working 
once a project been made. 


Those effects are there to give you a nice look, but are not mandatory; for example, 
if you are building a 2D game within Unreal that does not require any of the heavy 
bloom effects, or others, you can still disable or enable any of them upon your request. 


You can access the effects from the Rendering section underneath the Project 
Settings window from the Edit menu. Pull all the way down to Default 
Postprocessing Settings, and then pick what you want and leave the rest: 


Engine - Rendering 


‘bes These settings are saved in DefaultEngine.ini, which is currently writable 


Generate Mesh Distance Fields 
Generate Landscape Real-time GI Data 
Distance Field Penumbra Size 
DBuffer Decals 

4 Tessellation 
Adaptive pixels per triangle 


4 Postprocessing 


S § s86e8a 
[=] 
74 


Separate Translucency 

Custom Depth Pass 
4 Translucency 

Translucent Sort Policy Sort by Distance w 
> Translucent Sort Axis 
4 Default Postprocessing Settings 

Bloom 

Ambient Occlusion 

Ambient Occlusion Static Fraction (AO for baked lighting) 

Auto Exposure 

Motion Blur 

Lens Flares (Image based) 


Anti-Aliasing Method TemporalAA v 


E | 


4 Optimizations 
Early Z-pass Decide automatically ~ 
Movables in early Z-pass 
Clear Scene Hardware clear w 
Accurate velocities from Vertex Deformation 


4 Editor 


Wireframe Cull Threshold 
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The post process volume 


While you can have an overall post processing setting set up inside Projects Settings, 
you can still add more details and even apply post processing effects to a certain area 
within a map. 


Just like all the other awesome features of Unreal Engine, this is handled by using a 
primitive, cubes, which is usually called volumes, to control it at runtime (or even at 
edit time, just as in this feature). The post process volume could be added to a leval 
and then its position or size could be changed, which might be a reason for getting 
different results. 


These types of volumes are the only possible way to manipulate post processing 
parameters. While other engines handle post processing by connecting them to the 
camera as components or something else, Epic decided a long time ago to go for it 
with regard to volumes. Why? 





While the answer to that question is Known only by the engineers who built 
the engine, it is very obvious that extendability is the reason behind most of the 
decisions made for the engine. 


Let me go into more detail. If the volume is working as an attachable component or 
attribute to the camera, that means it will affect the overall look of the camera all the 
time, but the volumes within Unreal are different. They mostly affect the camera as 
long as it exists inside that volume... BRILLIANT!!! 
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That means you can have different blur types within the scene, just based on the 
spread of your volume. For example, if you havea character underwater, and he/ she 
gets out of the water, you can apply two different volumes, one for the water area 
and the other outside. Both have different blur values; both have different color 
correction. Unreal will make the transition, while your character/ player navigates 
between both. Brilliant, isn't it? 


After all, Unreal still adds a default post processing class/ struct into each camera, so 
you can set up the different post processing effects per camera too, if that makes you 
consistent with whatever background you came from: 


4 Camera Settings 
Projection Mode 
Field Of View 
Constrain Aspect Ratio 
Aspect Ratia 
Use Pawn Control Rotation 
Post Process Blend Weight 
Post Process Settings 
> White Balance 
> Color Grading 
> Film 
> Scene Color 
> Bloom 
> Light Propagation Volume 


> Ambient Cubemap 


> Lens Flares 

> Ambient Occlusion 
> Global Illumination 
> Depth Of Field 

> Motion Blur 


> Misc 


D 
i 
I 
[ 
[; 
I 
I 
> Auto Exposure 
[ 
i; 
[ 
D 
I 
I 
I 


> Screen Space Reflections 


Use Field Of View for LOD 
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Each post processing volume within Unreal Engine works as a blend layer, while 
other blend layers might bea result of something else, like another post process 
volume or UI, for example. Each layer could havea weight, so you can blend 
between the different effects with a linear interpolation curve (that is, lerp). As 
mentioned earlier, the reason behind having volumes is that it makes sense that the 
post process volume will only be applied and blended when the camera is within its 
bounding box, unless the Unbound property is checked (check the next paragraph, 


don't just wonder'!). 


Epic's team was very smart when designing that system within the Rendering 
toolset. What if the designer wants to give one color tine, one mood, and one bloom 
value for the whole level? Does it make sense to havea GIANT post processing 
volume to affect the whole level, and just scale it up? Or does it make sense to just 
keep putting volumes all over the level? 


What they found makes sense was actually what I really feel makes sense. They just 
put a property within the post processing volume that is set to eithert rue orfalse. 
That attribute, called Unbound, if checked, means that the post processing volume 
will affect the entire scene, regardless of its size, and regardless of the camera's 
position within it. 


What made that make really perfect sense is that it pts the concept of the level 
blueprint; while there is anormal blueprint per object or per actor, there is a global 
blueprint for the entire level. It is the same here: if you just set that small property, 
then the volume will be a global effector for the level. 


The properties 


Hereisa list of the normal properties found in the post process volume, regardless 
of which effect you are going to use, meaning that those are the normal minimum 
requirements for a post process volume: 


4 Post Process Volume 
> Post Process Settings 
Priority 


Blend Radius 


Blend Weight 


Enabled 





Unbound 
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Here you go: 


A 


po 


Post Process Settings: This is an expandable list that contains Post Process 
Settings for all the effects for that volume: 


4 Post Process Settings 
> White Balance 
> Color Grading 
> Film 
> Scene Color 
>» Bloom 
> Light Propagation Volume 


> Ambient Cubemap 


> Lens Flares 

> Ambient Occlusion 
> Global Illumination 
> Depth Of Field 

> Motion Blur 


> Misc 


[ 
[ 
[ 
[ 
[ 
[ 
[ 
> Auto Exposure 
[ 
[ 
[ 
[ 
[ 
[ 
[ 


> Screen Space Reflections 





Priority: The order when it comes to blending multiple volumes. The volume 
with the highest priority value will take precedence over all other volumes 
overlapping with it. 


Blend Radius: Distance measured in Unreal units around the volume at 
which blending with the volume's settings takes place. 


Blend Weight: The amount of influence the volume's properties have. 
A value of 1 means It is a full effect, while the value of 0 means there is 
no effect. 


Enabled: Shows if it is working or not. 


Unbound: Remember, that's the local VS global option! It defines whether 
the bounds of the volume are taken into consideration or not. If the value is 
t rue, the volume affects the entire level, regardless of its bounds or position 
from the camera. If it is set to f al se, the volume only has an effect within its 
bounds and on the camera inside those bounds. 


One thing to mention is that if the volume is going to be Unbound, the Blend 
Radius value will be disabled as it makes no sense to use it any more. 
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The available effects 


Unreal Engine has lots of different post processing effects in order to guarantee your 
full control over the pnal look of each pixel in your games. As it is not only one effect 
or one parameter: the following is a list of all the support post processing effects in 
detail for each one of them. Just keep in mind that they are not ordered with their 
priority or with a certain rendering order, but are just ordered as they are found 

on a Post Processing Volume details panal. 


While the effects used to be arranged within the settings panel in a different order, as 
the engine keeps upgrading, Epic keeps adding new effects and arranging the whole 
menu in a different way. The available effects include: 


J 


White Balance 

Film 

Anti-Aliasing (AA) 

Bloom 

Color Grading 

Depth Of Field (DOF) 
Auto Exposure (Eye Adaptation) 
Lens Flares 

Post Process M aterial 
Scene Fringe 

Vignette 

Grain 

Screen Space Reflections 
Light Propagation Volume 
Ambient Occlusion 

Global Illumination 


Joo To Joo To Do Jo To To To To To To To To To To 


M otion Blur 


Jo 


Screen Percentage 


There may be afew more effects that could not be listed, or could even be classibed 
as color corrections (but there is not an actual list or tab named color correction). | 
decided to include a list of the available post processing effects, as the menu is not 
super clear. For example, Anti-Aliasing is a world standard post processing effect 
nowadays, but there is not an actual menu or tab with that name, and the AA options 
are listed under a M isc. menu. 
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It is the same for the popular Fringe, Vignette, and Grain. As the three of them are 
super popular and famous world standard effects, they are tabbed under one menu, 
named Scene Color. So, the preceding is just for your reference to let you Know what 
you have and can achieve with the post processing volumes. 


Go ahead and keep enabling and disabling the different effects, keep changing 
values, to understand how the end result will look. The effects' names are 
self-explanatory, but believe me, the best practice here to learn all of them is by 
enabling and disabling them to learn about their effect. 


One rule of thumb I would give is that when you change any value for a certain 
effect, try the highest and the lowest values; both will give you an idea of what you 
could achieve in between! 


TgSgevgp'Ecr wig 


Sometimes, by design, the map or level has to reyect something. Having a mirror, 
water drops, or metallic parts around will never look real without reyecting some 
parts of the environment. And that's when it is time to use Reyection Capture 


Reyection Capture is not only the name of an actor you use inside the editor, but also 
the functionality itself at the same time. While having real-time reyections is really 
costly performance-wise, it is possible to reduce that cost using Reyection Capture 


Simply, itis the same concept as lightmaps; you can bake those things earlier ina 
sort of a map and use them later at run-time. Unreal Engine has inside its toolset 
what is called Reyection Environment via the Reyection Capturers. 


The Reyection Environment toolset provides effcient reyections in all the directions 
of the scene, just like metal surfaces (the idea is to have objects that have materials 
with a high and noticeable specular and alow roughness values, so it is not only 
metals!). While it sounds like an awesome feature, the only con for it is that it does not 
provide reyections of moveable (dynamic) objects or sharp reyections, which usually 
could be achieved using other Unreal methods, just like Sareen Space Reyections. 


By setting up some light sources and building the lightmass once, you are ready to 
start setting up the reyection environment. You will never be able to build it without 
having a prebuilt lightmap, as its calculations are based on having indirect diffuse 
lighting around the scene. 
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Setting up the reyection environment is super simple. It is done usually by inserting 
the Sphere Reyection Capture actor into the scene (mostly we use the sphere shape, 
but still there is a cube one, and we will discuss the differences later): 


Search Classes 


Recently Placed 


Basic Atmospheric Fog 


Lights 
i Exponential Height Fog 
Visual Effects 7 


BSP : ; 
Sphere Reflection Capture 





Volumes 


All Classes Box Reflection Capture 


Deferred Decal 





Reyection captures acts a lot like lightmaps. It needs to be baked several times, and 

all the time, as it is not always kept up to date. That means that if you added anew 

object into the scene, moved an object, or even made any change to the scene's look, 
those changes will not be captured. 


Only loading a map or building lighting will update the rey ection captures. So 
anytime you make a change and you want it to be included and captured, you have 
to select a capture and click Update C aptures in order to capture the latest changes: 


4 Reflection Capture 


Influence Radius 


Brightness 





4 Rendering 
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As with all the other optimizations you are going to make with Unreal, there is 
always a way to visualize and review the changes you make. While you are able to 
display the indirect light cache, you are able to display what is being captured by the 
Sphere Reyection Capture actor by enabling the Reyection Override view mode. 
And you'll see how reyective the surfaces that you have are: 





The way the reyection environment mechanic works is very simple. It works 

on capturing the static objects of the scene at different capturing spots and then 
projecting them as a reyection onto simple surfaces like spheres; that's the reason 
behind the spherical shape of the capturer actor. 


The capturing spots are manually selected by you; by just placing the Reyection 
Capture actors, you ask for Unreal to depne this area as a reyection capturing area. 
And as long as you are inside the editor and building up your levels in Edit mode, 
the reyections on the spherical shape will keep updating in real-time during the 
editing process. But once you hit Play or package your project into a game, then 
the reyections will be static during runtime. 
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TgSgevop'Ecr wig'cevtu 
There are two reyection capture actors supported by Unreal Engine. You can pnd 
both of them listed in the M odes panei: 


A Sphere Reflection Capture 





Ñe Box Reflection Capture 


The main difference between them is the shape of the capturer itself, as the shape of 
it is the most important element of this process. The shape works by depning which 
parts of the scene are captured into the cubemap and then which part of the scene 
can receive rey ections from that cubemap. The supported two shapes are 

as follows: 


Å Sphere shape: The sphere shape is the most useful one as it has no corners 
(discontinuities) and itis hard to match the reflected object. 


As you can control the radius of the effect, smaller captures will override 
larger ones, so you can provide refinement by placing smaller captures 
around the scene. Imagine that you have a room, putting a large onein the 
middle while putting smaller ones in the corners will be your best solution 
to get it all perfectly done. 


Using the orange gizmo surrounding the sphere shape that is visualizing the 
radius, you can control which pixels can be affected by the cubemap: 
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Å Box shape: It is easier to call it the useless shape, or the limited one, as it 
only works well when it is used with rectangular rooms, but still, lots of 
people use the sphere shape for that situation too! Lots of people just don't 
trust it for the sake of being a cube, as it produces lots of artifacts due to the 
projection onto a box shape: 





Asis the case with the sphere, the box has a gizmo that displays its range too 
(also in an orange color). 


The fog effects 


While all other engines support only the Fog feature, Unreal Engine's team decided 
to give us two types of fog, based on the targeted usage; each type has its own 
parameters that could be used to depne its look. The two supported fog types are: 


Å Atmospheric Fog 
Å Exponential Height Fog 
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Atmospheric Fog 


Atmospheric Fog gives you an approximation of light scattering through a planetary 
atmosphere: 
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Adding it 
By adding an actor from the visual effects section of the M odes panel, you will have 
the Atmospheric Fog type installed into your level directly: 





[ 207 ] 


Enhandng theVisual Quality 
Here's how to add it: 


Nir Modes 


r 
Recently Placed A Post Process Volume 
Basic 
Lights Atmospheric Fog 


Visual Effects 
Exponential Height Fog 


BSP 


Volumes Sphere Reflection Capture 


All Classes 


Box Reflection Capture 
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In order to be able to control the þnal visual look of the recently inserted fog, you 
would have to make some tweaks to its properties attached to the actor: 


Å Sun Multiplier: An overall multiplier for the directional light brightness. 
Increasing this value will not only brighten the fog color, but will also 
brighten the sky color as well. 


Fog Multiplier: A multiplier that affects only the fog color (not the 
directional light). 

Density Multiplier: A fog density multiplier (not affecting the directional 
light). 

Density Offset: A fog opacity controller. 

Distance Scale: A distance factor compared to the Unreal unit scale. This 
value is more effective with very small worlds. While the world size 


increases, you will need to increase the value too, as larger values cause 
changes in the fog attenuation to take place faster. 


Joo > D> D> 


Å Altitude Scale: The scale along thez axis. 
Å Distance Offset: The distance offset in KM in order to manage large distances. 


Ground Offset: An offset for sea level (normally the sea level is 0, and 
while the fog system does not work for regions below sea level, you need 
to make sure that all terrain is above this value in order to guarantee that 
the fog works). 


Jo 
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Å Start Distance: The distance from the camera lens that the fog will start. 


Å Sun Disc Scale: The size of the sun disc; keep in mind it couldn't be 0, as 
before, there was an option to disable the sun disc, but in order to keep it 
real, Epic decided to remove that option and keep the sun disc, but gives 
you the chance to make It as small as possible. 


Å Precompute Params: Recomputation of precomputed texture data: 


° Density Height: Fog density decays height controller. The lower the 
values, the denser the fog will be, while the higher the values, the less 
scatter the fog will have. 


° Max Scattering Order: A limit on the number of scattering 
calculations. 


°  Inscatter Altitude Sample Number: Number of different altitudes 
where inscatter color will be sampled: 


4 Atmosphere 


Sun Multiplier 
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Exponential Height Fog 


That is a special type of fog, which has some requirements in order to work perfectly. 
While the Atmospheric Fog type can be added anytime or anywhere and it works, 
the Exponential H eight Fog type requires a Special type of map where there are low 
and high points, as its mechanics include creating greater density at the low places 
of a map and less density at the high places of the map, and there will be a smooth 
transition between both areas. 
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One of the most interesting features of Exponential H eight Fog is that it has two fog 
colors, the prst one is for the hemisphere facing the dominant directional light, and 
the second one is for the opposite hemisphere: 











Adding it 

As before, adding the volume type is very simple: from within the same Visual 
Effects section of the M odes panel as before, you can select the Exponential H eight 
Fog actor, and þnally drag and drop it into the scene. But as you can see, even the 
icon infers the high and low places from the sea level! 


=» = Exponential Height Fog 
= 





In order to be able to control the þnal visual look for the recently inserted fog, you 
would have to do some tweaks to its properties attached to the actor: 

Å Fog Density: The global density controller of the fog. 
Fog Inscattering Color: The inscattering color for the fog (the primary color). 


Fog Height Falloff: The height density controller; this controls how the 
density increases as height decreases. 


Fog M ax Opacity: The maximum opacity of the fog. A value of 0 means the 
fog will be invisible. 


Start Distance: The distance from the camera at which the fog will start. 


Po Do pe) De 


Directional Inscattering Exponent: The size of the directional inscattering 
cone. 
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Å Directional Inscattering Start Distance: The start distance from the viewer of 
the directional inscattering. 
Å Directional Inscattering Color: The color for directional inscattering, used to 
approximate inscattering from a directional light. 
Å Visible: The fog visibility. 
Å Actor Hidden In Game: Enable or disable the fog in-game (it will not affect 
the editing mode). 
Å Editor Billboard Scale: The scale of the billboard components in the editor: 
4 Exponential Height Fog Component 
Fog Density 0.02 
> Fog Inscattering Color 
Fog Height Falloff 
Fog Max Opacity 
Start Distance 
4 Directional Inscattering 
Directional Inscattering Expone 400 | 
Directional Inscattering Start C 
> Directional Inscattering Color 
4 Rendering 
Visible 
Actor Hidden In Game 
Editor Billboard Scale 
Summary 


Congratulations! Reading the summary means that you reached the end of this 
chapter. Well done! 


Having lights within a game is essential, and without light sources you will probably 
see nothing. But there should also be wisdom behind this process; adding too many 
light sources could come at a cost, and the game performance might get worse. But 
having something like lightmaps makes it easy to do all the lights you want, make 
the map look just like it should, and just bake the lightmaps, and that will save the 
day. You just learned not only this process, but also how to be prepared for it. 


You have also gone through lots of fun, and specially through the post processing 
volumes, and how and why you would use them. All their parameters and the 
effects that can be achieved using them, all of that you went through from zero 

to hero and you have simply mastered it. 
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Sometimes the environment has to reyect something; it might be water doing it or 
even a mirror, but doing real-time reyections Is always costly, and not recommended 
in games, but there is always a way around that. You have just mastered how to use 
the reyection probes to achieve such a result. 


Fog is one important feature within any engine; it doesn't have to be used in the form 
of fog, but using it always has its own dramatic effect and impact over the story and 
the gameplay experience, and you just learned the different types of available fog 
and how to use them. 


Now go ahead and keep tweaking the visual look of your maps, and once you are 
pretty satisbed, go ahead and take some screenshots; yes, you are in a great moment 
now, so share them on Twitter, and don't forget to use some hashtags to reach more 
of the Unreal and game dev community. Use things like#unreal engine or#ue4, 
#gamedev, and #i ndi edev, which areall active hashtags. Once you have done, go 
straight away to the following chapter, where we are going to learn how cinematics 
are made in games! 
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Cinematics and In-Game 
Cutscenes 


Cinematics, what a wonderful thing we havein games nowadays. Regardless as to 
whether the game is based on a story or not, games usually have cutscenes. If it is 
not to tell a story, then it is to direct the player correctly through the game. 


While some companies prefer to create their cutscenes within a third-party animation 
software such as 3dsM ax or Maya, and pretender it, in order to get the best quality, 
other companies prefer to do the cutscenes in the engine itself, in order to get the 
smoothest experience. Both are pne, but the last one is the best. But why? 


Well, creating cinematics and prerendering them outside the engine, will give 

an unexpected level of quality that is not consistent in the game, so the player 
experience will be like a zigzag; a player will enjoy a certain level of quality while 
playing, but a totally different quality while watching the cutscenes. 


But using the in-engine solutions in order to create the cinematics will not only make 
sure that the player will be seeing all the game and its movies with a specipc quality, 
but also once a cutscene ends, the player will move smoothly into the gameplay. 


It is very common in some games that by the end of a cutscene, your character is 
holding a gun, but once you go back to the gameplay again, you pnd him holding 
another weapon; that's because of the predictions the designers made. But if the 
cutscene is being rendered in real-time in the engine, then whatever weapon or 
position your character has by the end of the cut scene, the gameplay will continue 
within the same yow! 


Cutscenes or cinematics within an Unreal Engine are very easy to create, as long 
as you have, as the responsible editor, the basic knowledge of animations and key 
frames. Matinee is just like a curve or tracks editor; no more. 
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Keep in mind, while Matinee is the cinematic solution within Unreal right now, 
there are better and more powerful cinematic solutions being developed by Epic, 
one such solution being Sequencer. It is currently enabled for experimental usage. 
Which means that in the near future, within 4.12 or 4.13, you might start using 
Sequencer rather than M atinee. 


By the end of this chapter, you'll be able to perform the following tasks: 


Å Understand and use Matinee 

Create cutscene actors in different ways 

Understand the difference between the tracks 

Use the Director to create a mix between cameras and actions 
Animate anything and add it to a cinematic 


> To > To To 


Run the cinematic at certain moments 
Å Savethe cinematics into a video format 


With all that said, let's get started! 


Matinee actor (cinematic actor) 


Let's now stop referring to cinematic or cutscene, and let's call it Matinee, as this is 
how the Unreal Engine is calling it within the ecosystem. So just to make It clear, in 
case any of your maps include Matinee, that means you need to add a Matinee actor 
into this map. You can have endless amounts of M atinee actors inside one map; there 
is no limit, and it is back to your needs and story. 


But you have to keep in mind that one M atinee can't call another one, which means 
you can't do half of the show inside one M atinee actor, and try to call another Matinee 
to continue the show. This is not going to work, and that's the reason behind the topic 
of Director, which will be discussed later in this chapter. 


So, think about it in this way: one Matinee actor equals one piece of cinematic. Keep 
in mind, those M atinee actors are parts of the map, which means, they can't be part 
of the content browser, or to put it another way, they are not assets, they are just part 
of an asset, which is the map. 


So, you can't create a M atinee inside the content browser and drag and drop it into 
the map; this will not happen. The only thing related to a Matinee that you can create 
at the content browser, is called Matinee data, which basically involves holding two 
attributes to be used within any Matinee, and you'll rarely need this! 
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Now, if we want to introduce the M atinee actor into the scene, in order to start 
creating some sort of in-game cinematic, there are two methods to create a Matinee: 


Å From thetop menu bar, you can choose the Cinematics button, and this 
will give you two options, either to create a new Matinee through the Add 
M atinee button, or you will find a list of the current Matinee actors inside the 
current map, and clicking any will open it. Keep in mind, once you choose 
Add Matinee, the newly created one will be exactly at the center of the 
current view, not at the zero of the map as most people would expect. 
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Å Theother way is via the M odes panel; you can find the actor inside the All 
Classes section. 
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Whichever way you decide to follow, you'll have the M atinee inside the map, 
represented with this icon: 





The Matinee Editor will launch right away for you. If it doesn't, then as you know, 
clicking the Cinematic button at the top bar will get it for you. 


A Matinee actor, apart from being a special type of actor that is designed to create 
those fancy in-game videos, also has some default settings that you can tweak for 
a better result or specifc result. By selecting M atinee Actor, you will activate its 
parameters set within the D etails panel. 
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The various options are: 


Å Matinee Actor: This has the following options: 
° Open Matinee: It is another way to open the M atinee Editor 
° Matinee Data: As mentioned before, you can create the data asset 
and then refer to it here 
Å Play: This has the following options: 
° Play Rate: The multiplier for playback speed. 


° Play on Level Load: If this set tot rue, once the map is opened, 
the cinematic will run. 


° Looping: Is it going to loop? However, be aware that if it is loopable, 
you have to stop it through the logic. 


° Skip Update if Not Visible: A Matinee is just a set of animation 
tracks for some actors. Setting this option tot rue will skip playing 
Matinee, in a case where all the actors involved in this Matinee are 
not visible. 


° Is Skippable: Is the player allowed to cancel this cinematic? This is 
good when some parts of the game are really important to the flow, 
while other parts are not essential to watch. 


° Is Playing: It returns the current state of the M atinee. 


Å Rewind: This has the following options: 


° Rewind on Play: Setting this tot r ue, will force the cinematic to play 
in reverse, from the back to the start. 


° No Reset on Rewind: When setting this tot rue, and the previous 
option ist rue as well, oncethe first play is completed, and this 
Matinee is going to loop, the animations will start from the last 
positions. 


° Rewind if Already Playing: What if you gavea Play command to 
the Matinee while it was still playing? This option determines if it 
is Just continuing or rewinding. 


Å Cinematic: This has the following options: 


° Disable M ovement Input: Disable or enable the player controller 
movement. 


° Disable Look at Input: Disable or enable the player mouse or 
analog sticks. 
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° Hide Player: Hide the player or keep it as is. 


° Hide Hud: Keep the UI or just hide it. But keep in mind that some 
UI likea UMG at the world space will still be shown. 


The rest of the settings are the same ones shared between all actor types, such as 
Transform, Rendering, and Actor. 


Matinee Editor 


Once you open Matinee Editor, you'll pnd it split into four main sections. Those 
sections are as follows: 


Å Toolbar: It has the main controls that will allow you to insert the keys, play 
or stop, or even set some helpful values for display, such as the playback 
speed for instance: 





at Interpolation: > C) = A in Playback Speed: | Snap Setting: 
everse 
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Å Curve Editor: Once you have done some animations, you have the chance to 
push it even further forward, but changing the ease of the movement in order 
to fasten or slow it down. AIl that could be done through the Curve Editor. 
By the way, this is exactly like any other curve editor within Unreal, such as 
the particles Curve Editor, for instance: 
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Å Tracks: As we discussed earlier, a Matinee actor is just a set of actors with 
animated values. Those animated values have been set inside Tracks. Herein 
this section, you can add the actors and the tracks and keep them organized. 
For example, if you have a character that needs to move, apply animation. 
You'll probably be creating a folder named with the character name, and will 
add two tracks inside this folder, a track for the animations and a track for 
the positioning: 
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== Tracks 


All| Cameras Skeletal Meshes Lights Particles Sounds Events 





Å Details: The Details panel shows the parameters that could be changed, 
just like any D etails section of the Unreal Engine. But this pane! usually is 
disabled. The only way to enable it is either by selecting a track from the 
Tracks section, or by selecting a key. In both cases, the D etails panel will 
show only what could be changed: 
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Now you probably have an idea about what is the main goal of this editor, and what 
are the sections of it, and most importantly the functionality that each section serves. 
Now let's go ahead in more detail, and discuss the two major components that make 
a Matinee actor, namely the groups and tracks. 
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Groups 


Groups exist in the Tracks area of the editor only. It is the Unreal way to make 
things organized and tidy. Think about a huge cutscene, where there are lots of 
characters and enemies, vehicles and weapons, and pring. Just think about creating 

a war cutscene! That will make the Tracks area super crowded. And here comes the 
solution of creating what is like a folder to contain some tracks. For example, one 
character in that war scene, will have at least three tracks: animation, movement, and 
animation blueprint. Multiplying this minimum amount by the amount of actors that 
need to be animated is crazy. But if you created one folder per actor that can host as 
many tracks as it takes, then life will be easier. And if you have 10 character pghting, 
then you'll have 10 groups/ folders for each, regardless of the amount of tracks. You 
can then open or close, or hide or disable, each group/ folder. 


A group, by default, is anormal group. It has only one parameter, which is the 
group name. And here we see the extendibility of Unreal. Rather than giving us 

only one type of group, it gives us groups per actor type, so we can have a particles 
group, that has some options that could be applied for the particles, or wecan havea 
camera group, that creates a camera inside it, and so on. But usually, and most of the 
time, you will need to create normal groups through Add New Empty Group. Here 
is alist of the supported groups you can pnd within Unreal M atinee: 


Add New Folder 
Add New Empty Group 


Add New Camera Group 


Add New Particle Group 


Add New Skeletal Group 





Add New Lighting Group 


N ow if you want to assign any actor for the group you have created, all you need to 
do is the following: 

1. Select the actor from the viewport. 

2. Go back to Matinee. 

3. Right-click on the group itself. 

4. Choose Actors from the top of the menu. 
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5. Select the selected actor from the submenu: 


Select Group Actors 


Add New Bool Property Track 
Replace Group Actors With Selected Actors 
Add New Event Track a 
: Remove Group Actors 
Add New Animation Track 


Add New Float Anim BP Parameter Track SK_Enemy_FrostGiant_Captain(SK_Enemy_FrostGiant_Captain_4) + 





Tracks 


Once you have created at least one group, you will be able to create tracks, as tracks 
need somewhere to be hosted in. As tracks reoresent the animated value of the actors, 
you need to create actors prst, or choose them. Choose an actor as you saw in the 
previous section, via the group right-click menu. 


Once you've the group and actors inside (or even before putting actors inside), the 
right-click menu of the group will expose a huge list of the tracks that you can add. 


Be careful in adding a track and ptting the type of actor you are animating. For 
example, you can't add a track to control the material color while the actor is 
Light Source. 


So, you have to understand what each track is made for in order to be able to add 
them to the correct groups and actors. While the tracks' names are self-explanatory, 
this is the list of the tracks that you can add: 


== Tracks 


DirGroue 


z cameraView [Shot 0010] 





Now you understand the animation of the cinematics done inside tracks; those 
tracks control values of the actors, but not all actors, only the ones put inside groups. 
Finally, those groups should be inside a Matinee actor. This is the simple process of 
creating a cinematic, and in fact, the hard part of creating a cinematic is not here, it 
isin the direction and creation of the animations in the three-dimensional animation 
software. Apart from that, it is a very fun process. As it is fun, let's havea look at the 
Bellz cinematic. 
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Bellz cinematic 


Now with Bellz, my goal is simple; once the player reaches a certain point, which 
is by the end of the map, | need to trigger a 5 seconds cinematic, where the player 
stops, a beast comes and turns, and there are some fancy camera animations. 


Using the same tools, we discussed in the previous section, | was able to do this 
in afew quick steps: 


1. Put the beast skeletal mesh in the map: 





2. Create an empty group for the beast: 


All) Cameras Skeletal Meshes 





3. Add the beast as a skeletal mesh into this group, by selecting it from the map: 


Select Group Actors 
Add New Bool Property Track Add Selected Actors 
Aen) Poser Replace Group Actors With Selected Actors 
Add New Animation Track SRILA ATI IN 
Add New Float Anim BP Parameter Track Select Actor 
Add New Float Material Parameter Track Goto Actor 


Add New Float Particle Param Track Replace Actor 


Add New Float Property Track Remove Actor 
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4. Create another group, the type of camera, and that will create a new camera 
in the map. Give the group a namg; | named itcamer aVi ew: 


Add New Folder 


Add New Empty Group 


Add New Particle Group 
Add New Skeletal Group 


Add New Lighting Group 





5. Within the beast, add anew animation track: 


CLalatal hanes ae l rahbte Dartlar Err 
Actors p 
Add New Bool Property Track 
Add New Event Track 


Add New Float Anim BP Parameter Track 
Add New Float Material Parameter Track 
Add New Float Particle Param Track 

Add New Float Property Track 

Add New Movement Track 

Add New LinearColor Property Track 

Add New Particle Replay Track 


Add New Toggle Track 


Add New Color Property Track 

Add New Sound Track 

Add New Vector Material Parameter Track 
Add New Vector Property Track 


Add New Visibility Track 
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6. Then at the prst frame of the track, add a key, by pressing Enter (or the 
button at the top bar). | was then asked to choose an animation to insert: 
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7. Now I've animated the beast. 
8. Then choose the camera group. 
9. | added amovement track, to be able to move the camera: 


Actors 


Add New Bool Property Track 

Add New Event Track 

Add New Animation Track 

Add New Float Anim BP Parameter Track 
Add New Float Material Parameter Track 
Add New Float Particle Param Track 

Add New Float Property Track 


Add New LinearColor Property Track 
Add New Particle Replay Track 
Add New Toggle Track 


Add New Color Property Track 
Add New Sound Track 


Add New Vector Material Parameter Track 
Add New Vector Property Track 
Add New Visibility Track 
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10. Then | started to set some keys for the camera, and move the camera in the 
viewport after setting each key: 


CameraVview. 





11. By checking in the viewport, the camera will now havea yellow path that 
depnes its movement: 





12. But still the camera was not smoothing well. So! decided to go with a Curve 
Editor pxing. 


13. In order to enable a curve for a selected track, you can just press the Track 
button in the curve: 
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14. Now you can keep changing the curve, until you are good with the speed: 


ganar View Mlovariant 
BOs 


2000.00 
1000.00 


0.00 





3}—_-8.60—_ 8.00 9-50 4-00 +50 2-00 260 3-00 3-50 4.00 4.50 5.00 5-50 6-00 


15. Finally, everything is good, but will not run as expected, as all this needs to 
be bundled within the Director because there is a different camera used other 
than the player camera. 


16. So I added a Director group: 


Add New Folder 

Add New Empty Group 
Add New Camera Group 
Add New Particle Group 
Add New Skeletal Group 


Add New Lighting Group 





17. Now the Director asks which camera this track belongs to. | choose the 
cinematic camera, which is animated: 


Bip eipejeye) 


= | oss Hirsetor cameraview [Shot_0070] 





18. Now itisall alright. 
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19. The last step is creating a trigger from the volumes and putting it in the area 
where I| need the cinematic run on the player reach: 


Recently Placed e. Empty Actor 


Basic 


Lights Empty Character 


Visual Effects he 
Point Light 
BSP 
Volumes Player Start 
All Classes i 
F Cube 


Sphere 


Cylinder 





20. Finally, | set this simple logic that detects if the player (our GI adi at or class) 
has entered this volume in which the cinematic will directly play: 


J Play 


Ó OnActorBeginOverlap (cinematicTriggeringBox) O C Branch 
>» —-------------- p Tue > —— DP 


Other Actor p Condition False [> Target 


"T Get Player Pawn 


Player Index [0 | Return Value 


f re ° 
i) endingCutscene 





Now I've acinematic piece of video that is rendered real-time inside the engine 
itself, and triggered by the character reaching some point, not only that but also 
showing some animations and fancy camera movement. That's amazing and was 
fast compared to other tools and engines in the market! 
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The animated fog 


Almost like any other thing within Unreal Engine, you can do some animations for it. 
Some parts of the engine are super-responsive to the animation system, while other 
parts have a limited access. But speaking of the fog, it has a limited access in order to 
animate some values. You can use different ways and methods to animate values at 
runtime or even during the Edit mode. 


Color 


H eight fog color can be changed at runtime using Linear Color Property Track in 
Matinee. We are going to dive deep inside Matinee in the next chapter, but here is 
the recipe in advance! 


By following the given steps, you could change height fog color in-game: 


1. Create anew Matinee actor. 

Open the newly created actor within Matinee Editor. 
Create a height fog actor. 

Create a group in Matinee. 


m BW N 


Attach the H eight Fog actor from the scene into the group created in the 
previous step. 


6. Create a linear color property track within the group. 


7. Choose the Fog Inscattering Color or Directional Inscattering Color option 
to control its value (two colors is an advantage of that fog type, as we already 
discussed in Chapter 7, Enhancing the Visual Quality,€é renember?). 


8. Add key frames to the track, and set the color for them. 


Animating exponential height fog 
In order to animate exponential height fog, you can use one of two ways: 
Å UseMatinee to animate the Exponential H eight Fog actor values 


Å Useatimeine node within Level Blueprint, and control the Exponential 
H eight Fog actor values 


So go ahead, and add some animation to your fog if you have any. Just as we 
did with animation for the characters and cameras, try your best to animate 
some fog colors. 
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Saving the cinematic as video 


Sometimes, creating the cinematic is not a result of the need to play the game itself. 
Sometimes you want a piece of video for marketing or a best practice, or for creating 
a trailer or teaser. Then rather than running the game, and a recorder to capture the 
screen, Epic gives you the opportunity just to export it directly out of the engine, ina 
form that suits you; either a video or a sequence of images. 


In case you want to process your cinematic that way, itis very simple, just open your 
Matinee actor inside the M atinee Editor. Then from the top-right corner, by the end 
of the toolbar, you'll bnd a button called M ove. Click on it, and it will launch the 
Render M ovie Settings window: 


Render Movie Settings 


4 General 


Level /Game/Maps/gameLevel + @ © 4 


Teena -PlEVIACONSOLE -nomovie : 


Output Directory fff! fUsers/Muhammad/ De EPF 
Filename Format MovieCapture_{widthh<{height}_{qualit 


4 Capture Settings 
Frame Rate C 
Resolution 1280 x 720 (16:9) -+ 
Use Compression 
Enable Texture Stres 


Capture Type AVI Movie ¥ 
Compression Quality 
2 


4 Cinematic 


Cinematic Mode 


Allow Movement 

Allow Turning 

Show Player 
Show HUD 





Capture Movie 
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Within the window, you can choose either between a video or a sequence of 
images, and also the frame rate and the resolution. Those three options are the most 
important ones. Then you can depne some compressions or a different directory to 
be used. It is all a self-explanatory set of parameters, which you are going to leave 
most of them as they are. 


Once you are done, just hit Capture M ovie, and the movie will start playing and 
Saving at the same time. It will be slow, that's normal, as it has to write to the drive 
while playing. Depending on the duration and resolution, you'll get a different size, 
but don't be shocked if you pnd your video going beyond 5 GB; it is quite normal! 


Summary 


Now you have learned a whole new world of creativity that you can achieve only 
within the Unreal Engine, not only because of the visual quality, but also because 
of the ease of access. 


You have learned what the M atinee actor is, how it works, and how to create it, 
but most importantly, how to edit it. 


M atinee D ata is one little type of asset, and you learned how to get it, and where 
to assign it for your M atinee. 


A Matinee actor without the M atinee Editor is impossible. You've learned and 
mastered how to use the Matinee Editor, what are the essential parts of it, how 
to create curves, and what is the difference between the tracks and groups. 


You havea piece of cinematic done, congratulations! But still, you've got to either 
run it or export it for it to be used for something else like a trailer or marketing. 
You also learned how to process your cinematic further. 


Now before you go on to the next chapter, | would highly recommend you to create 
an outstanding cutscene and trigger it, or convert it to a movie. | focused on the 
movement of skeletal meshes, but this is because it is the most complex thing, with the 
same exact method. You can add audio and particles, so | recommend you try those 
too. In fact, go ahead and keep trying all the track types, it is going to blow your mind 
with new ideas! Once you're done, go ahead and progress to the next chapter. 
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A game without UI is something that cannot be made. Sometimes while playing a 
game, you can pnd there is no UI within the game while the gameplay is running. 
But even with those types of game, you must þnd a UI somewhere, at least in the 
game menus. 


The game UI could be something simple, starting from a simple text on the screen 
HUD, or might be something more complex, such as 3D UI edements, or even a map 
as with FogOfWar. 


The main functionality of the UI usually is not as a gameplay element, but itis a 
game play helper and a method for instant feedback. UI, as a helper, might be 

a map or a piece of text describing missions to the player, stating exactly what 
he she should do or where to go. 


However, it is mostly used as a feedback method, to tell the player about their 
current status, current health, damage, and what the player has earned, and what's 
been lost. A good player will always keep an eye on the entire game HUD, so as to 
learn on aregular basis about their progress. 


This sounds as if the UI has a heavy load on its shoulders, and too much to deliver, 
but in fact the methods used to create the UI in the past made it an even heavier 

load on the developer. However, with the invasion of the current high-end engines, 
new tools and methods have been made, and creating a UI for a game has become 

as easy as arranging stuff inside Photoshop or a similar application. It is a matter of 
taste now morethan a matter of coding. Even though there is some code to be added, 
or some blueprint logic, the process of constructing an intuitive UI that can pt any 
screen size is just a matter of taste! 
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By the end of this chapter, you will be able to: 


Å Understand the UMG concept and the editor 

Å Master the creation of the game UI by only using the UI widget actors 
Å Add and use animations to the UI elements 

A Connect the UI widgets to your game using either C+ or blueprints 


Having said that, let us get started! 


UMG as Unreal's UI system 


UMG isthe UI system and the framework has been used for a while now. For not 
along time, Unreal used to havea UI framework called slate. Slate is still being 
used underneath the UMG and the whole editor Ul. 


While slate was a little hard to deal with as a system and was neither super-friendly 
nor productive, Epic took a huge step to create the UMG system. 


UMG stands for Unreal M otion Graphics, and you can understand from its name 
that it is not only a UI solution, but also indispensable in creating tons and tons of 
other stuff. It is possible to produce things like ads and motion graphics with UM G 
and Matinee. I've seen lots of people pushing the engine boundaries and creating ads 
and motion graphics using the Unreal Engine, which used to be made with packages 
such as Adobe After Effects. 


The power within UMG is not only in its great performance, there are a few points 
that actually make it an amazing UI system. Let's look at them: 


Å UMG hasits own editor, the UMG Designer, which give the player ease of 
access to create advanced UI systems with a few clicks. 
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Å UMG allows users to create animation, not only static components but also 
animated UI components. Which means either the game UI or the product 
motion graphics will be juicy. 


— 
+ Addy Auto Key + iy 0.05 m AH io x Curve Editor 


astart_Button 


4 Background Color 


Blue 
Green 
Opacity 
Red 
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Å UMG is completely integrated with all types of inputs, which means that you 
can navigate through the UI using a gamepad, mouse or keyboard, by just 
using a simple node to enable navigating between the UI buttons or sliders 
with a controller or keyboard rather than a mouse. 


$ 
Add to Viewport => 


© Event Begin Play fm Create MyWidget_C Widget 


Class My Widget ~ Return Value Target 


Owning Player me \ J Set Keyboard Focus 


en D 


Target 


Target Button 0 





po 


UMG's performance is super stable. 


A UMG can be used to create a world space UI or screen space UI. This means 
that you can havea UI attached to an actor inside the world, and not just a 
HUD component. 


Play 


Options 





Credits 
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The game UI widget 


Within UMG the UI screens or panels are called UI widgets. A widget can have 
an unlimited amount of UI elements, which include subpanels. But think about 
a widget as a container for UI elements. 


The UI widget is an asset type, just like any other asset within Unreal. It is better to 
think about it as a blueprint, but a different type of blueprint. However, it shares the 
same methodology, which includes a designing part, where you can assemble some 
elements, and a logic part, where you can add logic or code for those designing parts. 


Now, let's create a UI widget, which is as simple as creating an actor blueprint and 
can only be created from the content browser just like any other blueprint. You can 
pick a widget blueprint from within the U ser Interface submenu. 


Create Advanced Asse 
Animation 
Blueprints 
Materials & Textures re 
Sounds Az Font 

Physics 
i ae : 

q Slate Brush 


| a 


Miscellaneous 


A A Slate Widget Style 


Blendables 
Paper2D 


~e 
— 





Artificial Intelligence 


| created mine, and just named it! nGa me UI . After creating it, do a 
double-click in order to open the UMG designer editor. 

Al Remember to be very organized! The project is getting bigger with time, 
and things might get out of control, only because you were unorganized 

Q at an early stage. Try to make a directory for similar things, and for the UI 

widgets I've created aUl folder within theB! uepri nts folder, as they 
are blueprints asset types at the end of the day, but a different type of 
blueprint. 


Now, as you have seen in the previous screenshot, there is an asset type called Font 
and it is tagged as User Interface, meaning that you can create and import font ples 
to be used as your UI font for the game. 


For Bellz, | have downloaded one of the free fonts online, and by just dragging and 
dropping it into the content browser, Unreal has detected its type and converted the 
font ple into an Unreal font asset. 
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y% Keep in mind that usually the fonts you need might be TTF or OTF 
þle formats. 


UMG Designer 


The UMG Designer is very interesting, as from the prst time you open it, you will 
have the feeling that it somehow does not look like all the other editors within the 
Unreal Engine. And that's true, as it has tools that you'll be seeing for the þrst time. 


The UMG Designer is exactly like the blueprint editor, not in how it looks but in its 
goal and objective, as both are not only used to create logic, but also to visualize and 
construct the actor, whatever the type of actors a UI or in-game item has (like an 
In-game object or character). 


N ow let's look at the main parts that create the UMG Designer. 


The Toggle mode 


At the top left corner of the UMG Designer, you will be bnd a Toggle button that 
allows you to switch the designer interface to two different types. They are: 


Å Designer: This is the default view of the UMG Designer, and it is the place 
where you'll be constructing your UI and putting things together 


Å Graph: This is the place where you'll be binding buttons and UI events and 
adding logic to control the different UI items 


A Designer > Ta Graph 





Palette 


The UI is just a bunch of text, images, sliders, and few other types of controls. H ere, 
within Palette, you will þnd all the control types supported by the Unreal Engine. 


If you are familiar with the Windows form for Visual studio, or something like QT, 
you will understand the term here. 
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@ Palette 


Search Palette 
4 Common 
) Border 
= Button 
v Check Box 
[2] Image 
[Œ] Named Slot 
© Progress Bar 
2 Slider 
F] Text 
¿J Text Box 
> Input 
> Optimization 
> Panel 
> Primitive 
> User Created 





The hierarchy 


Adding items to the UI widget could be done through the canvas or Hierarchy, but 
using any method, the added item will exist on both sides. This means that you can 
drag and drop items from Palette to the canvas or to Hierarchy, but in both cases, 
the dropped items will exist in Hierarchy and the canvas. 


= i. yee OE 
s= Hierarchy 
Search Widgets 


a [NewWidget Blueprint] 
E] [Canvas Panel] 
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Animations 


Sometimes you will need to add animation for the UI items, like pop-up windows or 
sliding panels and so on, and this is the place to do that. You can't import animations 
from third-party applications such as May or Flash, as any Ul-related animations 
must be created within Unreal in this panel. 


No Animation Selected 





Canvas 


The canvas is the area of action. This is where you'll be "drawing" and "putting 
together" all the UI elements. The canvas is like a grid, where you can place and 
align items. It has information for you, such as the screen aspect ratio you are 
using for the game. 
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The Details panel 


The Details pane! works like any other details pane! within the Unreal Engine. It 

is the place where you can set and adjust the different parameters for the currently 
selected item. Once you add a UI item to the canvas, you will be able to adjust all its 
parameters from here. For example, adding text will let you change Its size, color, 
the text itself, the anchoring, the text scale, and much more. 


i Details 
2f CanvasPanel_ü Wis Variable Open CanvasPanel.h 
Search 
4 Behavior 

Is Enabled 

Visibility Self Hit Test Invisible + | Bind + | 

F 

4 Performance 

ls Volatile 
4 Render Transform 
b Transform 


b Pivot 


a Navigation 


Left 
Right 


LU p 





Constructing the Ul 


So, how does this work? 


Well, itis very simple. In order to add content, you have to pick what you want from 
the Palette panel, and drag it, and then you can: 


Å Drop theitem within the canvas 
Å Drop theitem within Hierarchy 


The last step is to adjust the size, name, or scale of each item you have placed. 
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Whether you're working in a team, or even alone, you should havea UI design 
mockup before you start putting things together within Unreal. For Bellz, in order to 
always include the player in the gameplay, | came up with this simple and standard 
game UI design. 








()X 00 











Simply, the player will be seeing all the gameplay UI in the upper-right corner of the 
screen, in order to save lots of space for the player to focus on the game, enemies, 
and the objective itself. 


The UI will display all the information the player needs, and the values we have 
for the most important gameplay variables (health, coins count, and so on). As we 
worked on adding asystem for the Al to hit the player and affect his health, the 
player needs to be aware of the current health status, in order to take the decision 
to keep on pghting or running away to look for a health pack or such. 


Also, we have presented a collectables system, and we have added some logic for 
the player to allow him to do the collecting process, and increase the collected coins 
count. It is good to show the player how much he has got. 


So, the conclusion is, we need: 
Å A progress bar that can change the value to match the player's health 
An icon for the coin to distinguish the value being displayed next to it 


A 
Å A static text, X to be added next to the coin icon 
A 


A dynamic text that will always be changing to match the number of the 
collected coins 
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N ow, let's drag and drop items from Palette into the canvas, ordering them the same. 
One good tip is to use the [H orizontal Box] component, as it is good way to align 
things horizontally. 


a [InGameUl] 
4 E] [Canvas Panel] 
an Progress Bar 
4 Go) [Horizontal Box] 
[2] Image 
m] [Text] "x" 
T] coinsValueText 


a 
a 
a 
a 
a 
a 





As you can see, the [Canvas Panel] component is my default root for everything. I've 
added a scroll bar and a horizontal box. Within the horizontal box, I've added the 
icon for the coin, and the two pieces of text. Isn't it so simple and quick? By adjusting 
some colors, and scales, it looks like this: 





Now, one very important thing to keep in mind is that if you tried to use this UI 
in a different screen size (not 16:9) like the one being used while constructing the 
UI, probably things will get messed up, and you'll pnd items have been moved to 
different positions, and are no longer connected to the upper-left corners. 
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Here we come to the Anchors feature. By selecting any item, or parent item, you will 
bnd itis displayed like an anchor icon, which looks almost like a star. 





This star represents where the selected item is attached, and in case the screen size 
and the aspect ratio have been changed, it indicates how the item will be interacting 
and where it will be kept positioned and aligned to. 


Changing the anchor has usually been done in code and used to be a tedious process 
for the UI programmers, but within UMG, Epic has presented the anchors set where 
you simply can choose one of the screen corners to attach an item to, and then 
everything else will be done under the hood. 


By selecting an item from the canvas, you will see that the þrst option inside the 

D etails panel is Anchors. By simply clicking on it, you will have a drop-down list 
of all the possible positions on the screen. Pick the one you want, and the one that 
bts your needs. | have picked the top left corner for all my controls, as this is where 
| need them in all aspect ratios. 


4 Slot (Canvas Panel Slot) 


Position X 
=| as 


Position Y 
size X 
size ¥ 
> Alignment 
Size To Content 


Order 


4 Behavior 


ls Enabled 


Tool Tip Text 


Visibility 


4 Performance 
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Now the UI is perfect and ready to be used. However, | would like to add one more 
thing in order to push it further and to make it more pumping with life, and at the 
same time, to experience all the UMG capabilities. Let's add some animations. 


Adding animations to the UI 


Animations can be complex, but for the UI it is usually simple positioning over 
time, and this is usually triggered at a particular moment, and is not running all the 
time. Having animations in the UI might distract the player, that's why you've to be 
very careful while creating UI animations, as they have to be only informative, and 
not distracting. 


So, what am I going to animate here? 


Well, my plan is to create an animation clip to the value of the coins (the text 
component) in order to show to the player where the collected coin value went, and 
what values in the UI have been increased. It is this type of effect that you usually 
seein RPG games. 


N ow, from the Animations section, all you need to do is to create a new animation 
using the +Animation button and give it a name. 


Par neem search Animations 





If you've noticed, the whole animation panel was grayed out (disabled) until you 
created a new animation clip, which will enable the animation toolbar button. 
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From within the animation toolbar, you can hit the +A dd button, in order to get access 
to all the available items in your canvas. All those items can be animated. 


+ Add + 
CanvasPanel_] 


coinsValueText (HorizontalBox_397 Slot) 


HorizontalBox_397 

HorizontalBox_397 (CanvasPanel_] Slot) 
Imiaqe_106 

Image_106 (HorizontalBox_397 Slot) 
ProgressBar_54 


ProgressBar_54 (CanvasPanel_l Slot) 


TextBlock_127 (HorizontalBox_397 Slot) 





Select the item that you want to animate. For me, | used the coins text, as | mentioned 
before that the animation clip will be about driving the player's attention to the 
increased value of the coins. 


4coinsValueText 





Choosing a component to be animated will add it to the Animation panel, and 
display to you a Track selection button. 


The Track selection button will be displaying a list for you; this list contains all the 
parameters that you can animate for the current selected item. 


The animation we want to create is about increasing the size of the text, which means 
we need to scale the item. | will be selecting the Transform track to be animated. 


Tacky J ; 


HorizontalBox_397 Slot 
HorizontalBox_397 Slot 


Color and Opacity 
Cursor 

Is Enabled 
Justification 
Pivot 

Shadow Color 


Shadow Offset 


Visibility 
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The animation is simple and made of only three frames. Within the Scale parameter 
of the Transform track, | managed to set three keys, the prst and the last have the 
same value, which is a value of 1 to both axes, X and Y. The middle key has a higher 
value, in order to scale up the size. 


4coinsValueText 


4 Renderlransform 


> Location 
> Rotation 
al Scale 

x 

+ 
> Sheer 





That's it. | have now animation that | can play and trigger anytime. Keep trying to 
add different animations for different objects, try to explore all the available tracks to 
be animated, and don't be afraid of trying things. Remember that any new animation 
clip you create, Unreal will be adding it as apub! ic variable of the blueprint, so you 
can call it, play it, or stop it at any moment. 


4Variables 
a Animations 
coinValueChange 


Image_106 





ProgressBar_54 


Connecting the Ul with the game logic 


Now, though we have UI widgets being built, we still can't see anything when we 
hit Play, simply because the UI widget needs to be spawned to the player. Its content 
needs to be connected to some logic in order to change the health bar value or to 
change the collected coins count. 


In order to be able to go ahead, we have to make sure of a few things. Visual Studio 
will not allow us to write anything related to UMG without having things set up 
beforehand. So within theBe! |z. h header ble of the game, make sure that we are 
using the engine itself, not the minimal version of it. 


#ifndef _ PUREGAME H 


#define _PUREGAME H 
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//l replaced the EngineMinimal.h, in order to get access to lots of 
other things...Mainly was to enable the on screen debugging messages! 
// #include “EngineMi ni mal. h" 

#include "Engine. h" 


#endi f 


Now, thereis one more step to go. InsidetheBel!z.Build.cs ple where we 
enabled some modules and where we enabled the Al and Paper 2d, let's add two 
more modules, the UMG and the slate (slate and slate core): 


using Unreal Buil dTool; 


public class Bellz : Modul eRules 


{ 
public Bellz(TargetInfo Target) 
{ 
Publ icDependencyModul eNames. AddRange(newstring[] { "Core", 
"CoreUObj ect", "Engine", "“InputCore", "Al Module", "Paper2D", "UMG" }); 


//PrivateDependencyModul eNames. AddRange(new stringi] { D, 


|] Uncomment if you are using Slate UI 


PrivateDependencyModul eNames.AddRange(newstring[] { "Slate", 
"SlateCore" }); 


Uncomment if you are using online features 
PrivateDependencyModul eNames. Add("OnlineSubsystem’) : 


if ((Target. Platform == UnrealTargetPlatform Win32) || (Target. 
rm == UnrealTargetPlatform. Wi n64) | 


{ 


l 
| 
l 
Platfo 
| 
| if (UEBuildConfiguration. bCompil eSteamO0SS == true) 
| 
l 
| 
| 


{ 


| 
| 
l 
f 
l 
l 
l 
| Dynamicall yLoadedModul eNames. Add("OnlineSubsystemSt eam’ ) ; 
| } 

a, 

} 


} 


The most important part now is GameM ode. As you will recall from Chapter 1, 
Preparing for a Big Project, Chapter 2, Setting U p Y our Warrior, and Chapter 3, Designing 
Y our Playground, we were creating the base of the player and Al, and wehad alook 
at G ameM ode which is called Be! | z Ga me Mode. A s the game mode instance will exist 
within each map or level you load, adding the main logic for the game UI within the 
game mode will be the best strategy to follow. 
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Now open the header þleBel | zGameMode. h and make sure to: 


Å Add an event begin play function override 


A AUserWidget variable to be used as the game's main UI instance and 
another variable of the same type, to be published within the D etails panal, 
which will be holding the UI widget that we made 


#pragma once 
#1 nclude "GameFramework/ GameMode. h" 
#include "Bell zGameMode. generated. h" 


UCLASS( mi ni mal api ) 
class ABellzGameMode : publ icAGameMode 


{ 
GENERATED_BODY( ) 


public: 
ABel | zGameMode(): 


virtual void BeginPlay() override; 


protected: 
//The game Ul widget blueprint that been designed in UMG editor 


UPROPERTY (EditDefaultsOnly, BlueprintReadWrite, Category = 
"Ul", Meta = (BleprintProtected = "true")) 
TSubclassOf<classUUserWidget > GameUl Wi dget; 


//The in game instance of the UI 

UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category = "Ul", 
Meta = (BleprintProtected = "true")) 

class UUserWidget* GameUllnstance; 


} 
Now within the CPP þle, you will not be able to add any related logic without 
adding the header BI ueprint/User Widget. h in order to be able to control the 
User Wi dget variable. 


Now within theBegin PI ay method, all what we have to do is, to make sure that 
the game mode has an assigned instance of the game UI widget, and then use it to 
spawn a widget within the game, and add it to the player viewport. 


#include "Bellz. h" 
#include "Bell zGameMode. h" 
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#include "Gladiator. h" 
#include "Blueprint/UserWi dget. h" 


ABel | zGameMode:: ABel | zGameMode( ) 
{ 
//set the gladiator based blueprint as the default pawn class of the 
gamemode. Also we can assign it directly within the editor 
Stati cConstructorHel pers::FClassFinder <APawn> 
Pl ayerPawnBPCl ass(TEXT("/Game/ Blueprints/GladiatorCharacter")); 
if (PlayerPawnBPClass.Class != NULL) 
{ 
DefaultPawnClass = PlayerPawnBPCl ass. Class; 
} 
} 


void ABellzGameMode:: BeginPlay() 


{ 
Super: :BeginPl ay(); 


if (GameUl Widget != null ptr) 
{ 
GameUl | nstance = CreateWi dget <UUSer Wi dget >( Get Worl d(), 
GameUl Wi dget); 
if (GameUll nstance != null ptr) 


{ 


GameUl |! nstance- >AddToVi ewport(): 
} 
} 
} 


Now everything is good on the C++side. Do compile and jump to the editor. Once 
the compilation is complete, create a blueprint based on the Bellz game mode and 
assign the Ga me UI Wi dget variable to it. Then hit Play, and you will see that the UI 
appears once the game has started. 
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So, how do we do the same thing in blueprints? 


Well, it is easier and does not require much C++based work. When you want to do 
the same thing in blueprints, you'll not need to include any header ples or such, as 
everything will be on the editor side. All you need to do is to add a Create Widget 
node to the player, and choose the targeted widget for it. Finally, add this newly 
created widget to the viewport. Just the same steps, but via nodes and with fewer 
complications. 


f Add to Viewport 
© Event BeginPlay fm Create In Game UI Widget 


Class In Game Ul Return Value Target 


Owning Player ZOrder g 


A 





Both ways work pne, and lots of people tend to do this step in the blueprints side, as 
it is easier to keep making changes or switching between the different widgets faster! 


Now we have the Ul, and it is connected. But neither the animations nor the values 
of the progress bar and the coins are changing at all. And that's because we haven't 
connected the logic yet. 


Connecting the logic for something is a fairly simple process, as long as we already 
have the logic to calculate the value itself, which means all we needs to do on 

the widget blueprint side is to display a speciþc value, and this is usually done 
through bindings. 


For example, by selecting the progress bar we have, you will þnd a Bind button right 
away, next to its percentage value. By pressing it, it will take you right away to the 
graph, with a new bind being added for it. 


4 Progress 


Bar Fill Type Left to Right ¥ 


Is Marquee + § 





["46; "] 


Implementing the Game U | 


In the binding area, all you need to do is to get the correct value. As the health 
value has been stored and mated by the C++ code we made in Chapter 2, Setting U p 
Your Warrior, all I've got to do is just to get this value using a simple casting to the 
gladiator. However, keep in mind, getting the health value alone will not work, as 
you have to divide it by 100, which represents a percentage value. 


fe Get Percent 0 »+ Cast To GladiatorCharacter 


fe Return Node 


D- eeaeee 
Object Cast Failed > 


J Get Player Controller As Gladiator Character 


Return Value 
Player index [0] Return Value 
J Get Controlled Pawn 


Target Return Value P 
g Target Total Health 





N ow let's go ahead and bind the value of the collected coins text. After selecting the 
text from the canvas, you will pnd another similar Bind button as before, but this 
time it is next to the Text attribute of the text component. 


ad Content 


Teal Text Block | Bind 





In the binding area, with a similar casting to get the Gladiator/ Player blueprint, we 
can get the Collected Coins value and convert it to a text variable to be returned and 
used with the text component. 


= Get Texto >» Cast To GladiatorCharacter l 
te Return Node 


p n $ 
j i MERRTE- -==e b 
Object Cast Failed > 


————————— ® Return Value 
J Get Player Controller As Gladiator Character 


Player Index [0] Return Value 


F Totext (int 


JF Get Controlled Pawn = 
v ! Value Return Value @ 
Target Collected Coins 
v 
Target Return Value 
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Now running and playing the game will have the expected experience; you will be 
able to collect coins, and the value of the coins at the UI will change. Also, you will 
be getting attacked by the enemies, and this will affect your progress bar or health. 
But still there aren't any animations for the UI. The one we made Is to be used when 
coins get collected. 


Let us open the coin blueprint, and do a simple process in order to get and play the 
animations we made: 
1. Add areference to the C++ method we made, the one called OnGet Col! ected. 


2. Get the current GameM ode used with the map, and cast it to 
M ainG ameM ode. 


3. After getting the game mode, we can get the value of the G ameU I Instance 
that we made a few minutes ago in C. 


4. Finally, wecan call the Play Animation node, by using the CoinV alueC hange 
variable of the UI widget as the used animation. 


©} Event On Get Collected 


"o 
—— ——SeaaeE 
J Get Game Mode Target Coin Value Change 


Return Value 


— — - ee B SS ae 
id »+ Cast To MainGameMode >» Cast To InGameUl J Play Animation 
> 


>—»P asa i 
Object Cast Failed [> Object Cast Failed [> 
Target 


As Main Game Mode As in Game UI 
In Animation 


Target Game Ulinstance 
Num Loops to Play [1 | 


Play Mode 


“di J DestroyActor 
è 


Target [self] 





Now play the game once more, and try to collect coins, and see what happens. 
Exactly, the collected coins' animation effect will play on the UI. 
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What else? 


N ow, as you can see, | have created a main menu widget for the game. It is simple 
enough, and only has two buttons, one, to start the game and another one to quit. 
Go ahead and bgure out how to connect them to the game and how to make them 
the prst thing a player sees, and based on them, the player can either start playing 
or quit. 





As you can see, Bellz's menu has only two buttons, but the bigger the game, the 
bigger its menu will be: you might have more buttons such as options, leader boards, 
and so on. However, those two options are quite enough to get you even more into 
the process. 


‘rs Hierarchy 


d m Button 


E [Text] “Play” 
d m Button 
m [Text] "Quit" 





Don't be afraid to try new things, add animations for the buttons, change their colors 
based on the mouse events, and so much more. Keep trying and remember whatever 
you havein mind, you will be able to achieve somehow! 
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Summary 


Now you have gone through one of the most important processes of the game 
creation journey. Creating the UI is not only something interesting, but it could 
be one of those things that distinguishes your game. N ot only do fancy sound or 
amazing visuals or models makes a game perfect, but the UI can leave a perfect 
impression on the players about the way it works, the way it looks and the way 
it animates. All that could change the player's experience by 180 degrees. 


In this chapter, you have learned alot about the UMG and what makes it better than 
slate, and even the best UI solution yet within Unreal Engine since its prst release. 


UMG has Its own editor/ designer, and you have seen the main parts of its editor, 
and how or where to add things. 


M aking sure that a game [ts all of the available screen size has always been 
complicated. However, using the Anchor points within UMG, makes this super 
easy, and you just learned how to anchor stuff. 


The UI could be just perfect based on the assets used, but adding animations to the 
UI makes it more live and intuitive. You not only learned how to create animations 
for the UI eements, but also you learned how to play with them whenever you want. 


Displaying the different UI widgets is a simple process, which could be achieved by 
using C++or blueprints. You not only saw how to do this using both methods, but 
also you have learned what are the essential steps, headers and modules needed for 
a C++ project in order to make the UMG adjustable using code. 


Now go ahead, and spend sometime implementing the main game menu, add 
some fancy animations or even add more to the game UI itself. Try to add a map, 
notifpcations, missions, and so on. And once you feel good and friendly with the 
process of creating widgets and animations, then go ahead and pnd more in to the 
next chapter, where we will havea little chat about how to save and load values. 
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save the Game Progress 


Now that we have an almost complete player experience, you can hit Play and 
enjoy running from enemies, hitting them and collecting some coins, and most 
importantly, the player will have instant feedback through the UI. 


However, the experience will be lacking some industry standards. Think about a 
power cut while playing, or even consider that your player may be feeling bored 
and wants to close the game for now. What should happen? 


Exactly... The game progress should be saved. This is what we are going to do next. 


Saving a game could betricky, and could involve too many techniques in order 

to properly save the player data for all the supported platforms in a well-locked 
ble format. Fortunately, Unreal Engine gives us an interface for its complex save 
system, and all that we have to do is to initialize that save system and save or load 
the data. All the underlying mysterious logic has been put under the hood, starting 
from creating the ble format, to writing in binary and organizing the saved data in 
a well-managed way. 


By the end of this chapter, you will be able to: 


Å Build aSaveGame class to be used for game loading and saving 

Å Saveand load any game data using C+ 

A Understand the save and load workflow, and where to find the save files 
Å Useor open the saved data files 

Å Saveand load data using blueprints 


With that said, let's get started, and learn how to save and load! 
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Building the SaveGame class 


While most of the classes we have built so far have been based on the actor class, 
there are some functionalities that are not supported by the actor class and saving 
the data is one of those. 


In order to make a class that can be used as an instance to manage the game save and 
load, you'll need to create a class based on theSaveGame class. 


Al Add C++ Glass 


Choose Parent Class 


This will add a C++ header and source code file to your game project. Show All Classes 


savePackagesCommandlet 


O AnimGraphNode_SaveCachedPose 


Selected Class Save Game 
Selected Class Source SaveGameh 


Cancel 





| have created mine for Bellz, and named it Be! | zSaveGame. Choose a name that 
suits you and just create it. Once the Visual Studio opens, go ahead and open the 
Bellz. h þleor, in other words, the main header for your game (your game might 
not be named Bellz). 


Within the header pleBel |z. h, wewill beincluding some extra header ples in 
order to be able to use the save functionality within any class instance. We will 
be including: 


Å BellzSaveGame. h 
Å Kismet/GameplayStatics.h 
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But make sure that the new header bles are added under the Engi ne. h ple, 
otherwise you'll get an error. 


[il replaced the EngineMinimal.h, in order to get access to lots of 
other things...Mainly was to enable the on screen debugging messages! 
|| #include “EngineMi ni mal. h" 

#include "Engine. h" 

#include "Bell zSaveGame. h" 

#include "Kismet/GameplayStatics.h' 


#endi f 


Once you have completed this, let us get back to the newly created SaveGame class, 
and open its header ple. This way, saving data is simple. For any value you need to 
save, you will have to add a variable for it within your header ble. So, if we consider 
that | need to save the player health value, which is yoat, that means | need to add a 
float variableto hold this value. 


UPROPERTY(VisibleAnywhere, Category = SavedVal ues) 
float PlayerHealth; 


And so on and so forth. For Bellz, I'll be saving health and collected coins, but you 
can save pretty much anything and everything in your game, as long as you are 
going to save the data or state of the entity. As we are still within the header ple, 
it is a good opportunity to add a couple of extra variables: 


Å Aninteger to hold the current player index 
Å A string to hold the save slot name (the save file name) 


This means that the header ble should look like the following: 


#pragma once 


#include "“GameFramework/ SaveGame. h" 
#include "Bell zSaveGame. generated. h" 


pee 
* 
ei 
UCLASS() 
classBELLZ API UBel!lzSaveGame : publ icUSaveGame 


{ 
GENERATED_BODY( ) 
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public: 
UPROPERTY(VisibleAnywhere, Category = SavedVal ues) 
FString SlotName; 


UPROPERTY(VisibleAnywhere, Category = SavedVal ues) 
uint32 Playerlndex; 


UPROPERTY(VisibleAnywhere, Category = SavedVal ues) 
ui nt32 CollectedCoins; 


UPROPERTY(VisibleAnywhere, Category = SavedVal ues) 
float PlayerHealth; 


UPROPERTY(VisibleAnywhere, Category = SavedVal ues) 
ul nt32 |astUsedWeaponl ndex; 


UPROPERTY(VisibleAnywhere, Category = SavedVal ues) 
FString Player Name: 


UBel | zSaveGame(): 


le 


Isn't this simple and straightforward? A slot name holder variable, and a player 
index variable are both essential to complete the save process. All other variables, 
such as player health, collected coins, and weapon index, are variables to hold 
values that I'll be saving for my game. 


Now, let's open the source. cpp ple, in order to complete the integration of the 
Bel | zSaveGame Class. 


#include "Bell 7h" 
#include "Bell zSaveGame. h" 


UBel | zSaveGame:: UBel | zSaveGame( }) 

{ 
SlotName = TEXT("CoinsSaveSl ot"): 
Playerlndex = 0; 


} 


Within the source ple, the only needed logic is to add the player index value, which 
is0 asthe game is for a single player, and as for the name of the save slot, | just 
named it with the coin's name. Name it anything you want, | could have named it 
pl ayer Dat a or Something but! just went with Coi nsSaveSl ot. 
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It looks like we have just added couple of lines, but in fact we have completed 

the job! Yes we have. Saving data within Unreal and C++1S avery simple process 
compared to the blueprints. Now all that we need, isto useUGamepl ayStatics::Cr 
eateSaveGameObj ect In order to save any value, or useUGamepl ayStatics::LoadG 
ameFromSl ot in order to load any value. 


For example, | would like to save the value of the player health and load it anytime 
the player starts the game, as long as it is not 0. 


Saving and loading game data in C++ 


As wealready have Included the needed header ples within the main game header 
ble, wewill be able to access theSaveGame methods from anywhere. 


So, within theAGl adi ator: : OnChangeHeal thByAmount(float usedAmount ) 
method of the player controller, l'II be adding a logic to save the health value 
any time it gets changed. 


void AGladiator:: OnChangeHeal thByAmount(floatusedAmount ) 
{ 
Total Health -= usedAmount; 
FOut put Devi ceNul | ar: 
this->CallFunctionByNameWithArguments(TEXT( "Appl yGet DamageEffect"), 
ar, NULL, true); 


//A message to be printed to screen 
FString message: 
//Creating an instance of the bellz save class 


UBel | zSaveGame* Bell zSaveGamel nstance = Cast <UBel|zSaveGame>( UGamep!| 
ayStatics::CreateSaveGameObj ect( UBell zSaveGame::StaticClass())); 


//Change the health value of the save class to match the current 
health value of the gladiator 


Bell zSaveGamel nstance->PlayerHealth = Total Health: 
//Store the health value to the save file 


UGamepl ayStatics::SaveGameToS! ot (Bell zSaveGamel nstance, 
Bell zSaveGamel nstance->SlotName, Bell zSaveGamelnstance- >Pl ayer! ndex); 


//update the message that will be printed 

message=TEXT( "The health been Saved ---> ") +FString::SanitizeFl oat 
(Total Health): 

//print a message to the screen 

GEngi ne- >AddOnScreenDebugMessage(-1, 2.f, FColor:: Green, message); 
} 
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So, to break it down easily, it starts as we have done before while building the 
gladiator, with the value change based on the passed variableusedAmount tothe 
function. Then follow these steps: 


1. Create an FString message string to hold a message that will be printed to 
the screen. 


2. Create an instance of UBel | zSaveGame named Bel | zSaveGamel nstance and, 
by asimpleCreat eSaveGameObj ect , wecan instantiate the class instance. 


3. Now we can change the value of the member variable P| ayer Health of the 
newly created instance to match the current player health. 


4. Then conprm the save, by calling the method SaveGameToS! ot, which 
usually takes three parameters: 


° Thesave game instance, which isBel | zSaveGamel nstance 
° Thesaving slot name, whichis Bel! zSaveGamel nst ance- >S| ot Name 


° Thecurrent player index, which isBel | zSaveGamel nst ance- 
>Pl ayerl ndex 


5. Finally wejust print a message on the screen, to make sure everything went 
all right. 


That was the save part, which involved simply saving a value. Now let's load it at 
the correct time. AtBegin Play of the same class I'll check whether there Is already 
a saved value, and if there is I'll be loading it as long as it is not 0 , otherwise, I'll give 
the player full health. 


// Creating an instance of the Bellz load game 


UBel | zSaveGame* Bell zLoadGamel nstance = Cast <UBel | zSaveGame>( UGamep!| 
ayStatics::CreateSaveGameObj ect( UBell zSaveGame::StaticClass())); 


//Access the correct slot and use the correct player index 


Bell zLoadGamelnstance = Cast <UBel |! zSaveGame>( UGamepl ayStatics::Load 
GameFromS! ot (Bel! zLoadGamel nstance->SlotName, Bell zLoadGamel nst ance- 
>Playerlndex)); 


//get the needed value and store it in a loacl variable 
float loadedPlayerHealth = Bell zLoadGamel nstance->Pl ayerHeal th: 


FString message: 
if (loadedPlayerHealth != 0.f) 


{ 
Total Health = |oadedPl ayerHeal th; 


message=TEXT( "The health been loaded ---> ") +FString::SanitizeFlo 
at( Total Health); 
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GEngi ne- >AddOQnScreenDebugMessage(-1, 2.f, FColor:: Green, message); 
} 
else 
{ 
message=TEXT("---- No HEALTH value been found on save files "); 
GEngi ne- >AddOnScreenDebugMessage(-1, 2.f, FColor::Red, message); 
} 


This way, | am able to save and load the player health at any time in the game. Now 
go ahead and repeat the same process for the coins or anything else, keep saving the 
different values, and try to load them. You will pnd it easy and funny as well. 


= ow 1A 
Vj g', Qicx'Og 
The ple format that is used by Unreal Engine in order to store the saved data is the 


* sav ble. You can pnd all the save bles (bles named with the slot names you use 
within the C++ code) in theSaveGames directory, within the game or the project. 


d h F > Bellz > Saved > SaveGames 


A 
gk Quick access 


E Desktop 


Jt Downloads 


=) Documents 


=) Pictures CoinsSaveSlot.sa 
Vv 





As you can see, Bellz's save game directory contains only one ble, which is called 
CoinSaveSlot.sav,thenameof the slot | deoned earlier. That means you can not 
only save multiple values within one save ple, but you can also save more than 

one save ble. So you can think of a single save ble as a table of values, and the save 
directory as the container of all the tables. And while you've got the chance to save 
unlimited amounts of save ples, it always better to keep things organized within one 
ble or even a few save bles, in order to avoid any corruption or complications. Check 
any AAA game (the Batman Arkham series, for example) made with Unreal Engine, 
and you will pnd it has around three save bles. Also, keep in mind, what if your 
game has multiple player proples? Would you put all the players’ data into one ple, 
or each player's data in its own ple? It is down to you how to organize it! 


And due to the fact that the*. sav þleis a binary data ple, it is not directly readable 
by any app or text editor, and you either need Unreal Engine to access Its data, or to 
make your way through some specifc editors. So don't bother trying to open this ple 
if you want to change some values, because it is not going to be straightforward. 
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Saving and loading game data in 
blueprints 


When it comes to save and load values for your game, C++ is the king. While 
anything else within Unreal Engine is faster and easier to make with blueprints, 
actually saving and loading data takes too many nodes within a blueprint. 


It could take exactly 15 nodes to store a value to the*. sav ble, and the same amount 
of nodes in order to load a value and use it. 


So, as we started in C++ by creating a class based on theSaveGame class, the same 
rule applies for the blueprint method. You will need to create a blueprint based on 
theSaveGame class, and in that case, | named itBe! | zSaveGame too, just asin the 
C++ example. 


O 


Bell7SaveGame 





Feel free to add any variables within this blueprint, as those variables will represent 
exactly what we were adding within theBel | zSaveGame header ple. 


But the most important part is creating aSaveGame variable within any blueprint that 
will be holding a logic to save or load data. 


4 Variable 
Variable Name 
Editable (= 

4 ¥ 
ne kai 
= 


Expose on Spawn 


Category Default 


Private 
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Finally, do the save or load itself. In either case, it is a matter of using one blueprint 
node call, which is Load Game From Slot in the case of loading, or Save Game To 
Slot in the case of saving. Regardless of which process you are using, there will be 
two main things in common. First, using the slot name you want to save to and load 
from. Second, you'll need to have a series of casting nodes to determine whether a 
slot or saving ble already exists or not. 


But the most important part is to always use the node called D oes Save Game Exist, 
before proceeding to save or load, in order to make sure that a save slot has already 

been made before. If there isn't one, it's the correct time to call the node Create Save 
Game Object, in order to create one. 


J Load Game from Slot 
SET 


b | —-p D- 
i Slot Name [CoinsSaveSlot] Return Value Local Saver 


F : User Index [0 | 
j Does Save Game Exist = 


D 
Slot Name [CoinsSaveSlot] Return Value NE E Branch = >» Cast To BellzSaveGame 
FR True 
User Index |0 | b : € > D 
att Object Cast Failed [> 


pÁ 
Condition False > ‘ 
= As Bellz Save Game 
J Save Game to Slot 


D D J Create Save Game Object ny 
Save Game Object Return Value Æ p b —— SET > 


Save Game Class Return Value Local Saver 
Slot Name [Coins Saves Slot | nile Sov Ganew 





User Index [0 | 


So basically, every time you need to load or save a value, you have to make sure that 
the value and its*. sav þlealready exists. 
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As you can guess now, if you would like to save a few bits of data, like the player 
name, gender, age, and score with some information about collectables and 
achievements, you will have at least something as complex as this! 





It is a screenshot from one of my early Unreal 4.1 games; it's the Save Game 
blueprint that has been used at that point. That was not easy to deal with. 


So, in case you are working on a blueorint-based project, or Unreal C+ project and 
you would like to support saving data via blueprints, | would highly recommend 
picking a tool from the Unreal marketplace. The Easy Save and Load tool gives you 
the power of the blueprint and it is faster than C+. 
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Writing some C++ code to save or load data would take some time, and saving 

the data via blueprints would require lots of nodes and connections for each value 
you need to save or load. But with such a tool you can save or load values using 
only one node call, which saves time, effort, and keeps your graphs clean. It is the 
best solution when you have to save and load and organize tons of values easily, 
quickly, and cleanly. There is more about this atht t ps:// www. unreal engine. com/ 
marketplace/easy-save-load. 


Summary 


Now you have gone through the process of saving and loading a player's data within 
an Unreal Engine game, using a type of logic, either C++ or blueprints. 


All Unreal Engine based games follow the same concept of saving data, with the saved 
data stored in binary bles. You have learned where to pnd and access those ples. 


Saving game data could be donein C++or blueprints; both methods work pne, and 
it is up to you to decide which one to follow. You have learned about both methods, 
taking into account the pros and cons of each. 


Now go ahead and keep saving different things in your game example. Try to save 
the entire map status and load it again. It will help you alot, and once you are done 
let's move forward to the next chapter, where we will be discussing more complicated 
data loading, and will be looking at the data tables and spreadsheets. 
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Controlling Gameplay 
via Data lables 


Not all games are small, sometimes games are gigantic, and full of information, 
details, and most importantly, numbers. Let us imagine an RPG game, where you 
have to run, kill enemies, and collect stuff. Enemies could have different attributes, 
such as damage, powers, effect, health, and lots more. While the collected items 
might vary even more, where a collectable X could increase your health by 2%, 
another collectable Y could increase your health by 50%. 


And that's the whole point behind data tables. It is a place where you can store 

data in avery organized way that is very friendly with the designer, and could be 
changed at any time, without the need to change the code. At the same time, the code 
can read it easily, regardless of any changes. 


Data tables started for just a few speciþc types of games, such as Tower D efense or 
RPG, but very quickly it became an industry standard, and is used with all types 
of games, at least to store the localization data! 


While data tables are essential, we will be diving into it, getting the guts of it, and 
learning how to use it in all circumstances. 


By the end of this chapter, you'll be able to: 


Å Professionally create an Excel sheet for Unreal 

Å Understand the data table asset and all its different types 

Å Create the needed data structure for any data table 

Å Usethe data table values within gameplay either in C-+++or blueprint 


[ 267 ] 


Controlling Gameplay via D ata T ables 


Data table sheets 


A data table sheet is something usually made by the game designers, and they pass it 
to the engineers inside the engine, so they can use it. It is basically just a table made 
in a third-party application. 


You can use something like Excel to build the tables as Excel sheets, or you can just 
use something free and reachable like a Google spreadsheet, but in general it needs 
to be just a table. 


Creating a table þlled with information seems simple enough, but as it is going to be 
sent to Unreal, it requires a couple of specications, in order for it to be processed: 


Å Thefirst cell of the table, in all circumstances, needs to be called Name 


Å Thetable needs to be exported to a. csv (comma separated values), as it is 
currently the only acceptable data tables format 


Å The cell names have no spaces, because those names will be variable names 
in the future 


When you are creating a table for your game, you have to make sure of those three 
things | mentioned. 


By looking at Bellz, | decided to create only two table samples: 


Å Thefirst oneis aweapons table which has the attributes for the player 
weapons: 


C i E 
Name Icon Display Name CooldownTime 
0 none icon Empty 
1 sword icon The Hot Blade 


2 axe icon The Sharpest 


3 hammer_icon The Mighty Hammer 
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Å Themissions table holds the information for the game's different missions: 


Collect 


1 1 


So Pion mon a w hw 
“moon em & wi w a he 


=k 





Now create your own, and convert it to. csv and drag and drop it into Unreal 
Engine in order to import it for using! 


Creating the data table asset 


Creating a data table asset is actually very simple, you've already done the work 
by creating the Excel sheet itself and converting itinto*. csv, butin fact this is not 
enough for it to work. 


You see from the previous point, that after dropping the ple into Unreal, it will ask 
you to "pick a structure" which means you can't proceed with the ple without having 
a data structure, which we will be covering next. 


AL DataTable Options 
Import As: 


DataTable 
Choose DataTable Row Type: 





But what | want to cover now, is how to create a data table within Unreal. Let's say 
you don't want to create your work within Excel or a Google spreadsheet, and then 
convert it, and þnally import it. You want to write your table directly within Unreal! 
And this ts totally doable! 
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Dragging and dropping a*.csv þle generating a data table asset, which you can 
create directly from within the content browser and the M iscellaneous section, will 
give you the same result. Despite that, you'll be asked for the data structure, but still 
you can create it directly within Unreal. 


AB Blueprint Class 


a= 
fh Blueprint Function Library 


Animation 


Materials & Textures 


Pe Blueprint Interface 


ry Blueprint Macro Library 


F 
Sounds b 
P 
} 
Miscellaneous EE l 
š E Enumeration 
p 
b 


Physics 


User Interface 


Blendables 
Paper2D i 


= 


Artificial Intelligence 


— 





If it happens and you want to change anything within the table, you can always 
make a change within the data asset inside the Unreal Editor, regardless of whether 
the table was made Inside or outside Unreal. But it is not recommended to always 
do updates and changes inside Unreal. If the table was made outside Unreal in the 
þrst place, then it is better to change it within the sheet, export to a. csv, and pnally 
reimport it for the data asset. This way it is better to keep everything organized; 
changes should be made outside Unreal. 


F Edit... 
* Rename 


Sw Duplicate 

mT Save 

X% Delete 

# Asset Actions 





Now we know that if we don't have a data structure, we will be using the default 
values, which will do nothing. This means we need to create a data structure that 
bts the data tables we have. 
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Creating a data structure 


So, now you've created the data table, and imported it into Unreal, but we still can't 
make sure of it, or in other words, the importing process is lacking a data structure, 
which made it only half import the process. Well, an unsuccessful one! 


While there are always different paths to create things, Unreal follows the same rule. 
As l've mentioned earlier, we are going to learn how to do that process for C++ and 
blueprint. Well then, there are two ways to create data structures, and any pts any. 
Which means you can make: 

Å A blueprint data structure that is used within blueprint logic 

Å A blueprint data structure that is used within C+ code 

A A C++data structure that is used within C+- code 

A A C++data structure that is used within blueprint logic 


What a variation we have! 


But usually, | like to keep things familiar, so | use the blueprint-based data structures 
in case my game logic is blueprint based. And of course, the C++ based data 
structures used with the game logic based on C+ This makes much sense! 


Blueprint data structure 


Now all you need to do is, from the content browser, choose Structure from the 
Blueprint option of the Add New menu. This will create a data structure for you. 


weapons 





Now you have a data structure asset, but it is empty. J ust double-click in order to 
open it inside the data editor. And all that you need to do, is to match the signature. 
Which means you create assets, with the names of the cell names in your Excel sheet 
and the same data type. 
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For example, for my weapons table, | can create (keep in mind that Bellz data 
structures are made in C++ and not in blueprint): 

Å String: Icon 

Å String: DisplayName 

Å Integer: Damage 

Å Integer: CooldownTime 


T Structure 


4 Structure 


“we New Variable 


` C TT a 
F Dispiayname looo a E 
LS eS a E 
F cooldowntime Basing vee oe 





Now, | havea data structure that bts the same signature of my imported data asset. 
N ow try to import the weapons table again and set its import data structure to that 
data structure which pts the signature. 


AL DataTable Options 
Import As: 


DataTable l 
Choose DataTable Row Type: 


weapons 
GameplayTaglableRow 





The resulting data asset will be fully imported now and can work just perfectly, 
and if you double-click on this asset ble, you will pnd it looks just the same as the 
Excel sheet. 
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i Data Table 


Icon DisplayName Damage CooldownTime 


sword_icon The Hot Blade 
axe_icon The Sharpest 
hammericon The Mighty Hammer 





C++ data structure 


Now creating a data structure will require us to create a new class, anew C++ class, 
and we can base it on anything. | like to use Actor as my base. 


alt Pick Parent Class 
a Common Classes 


An Actor is an object that can be placed or spawned in the 
world. 

A Pawn is an actor that can be possessed’ and receieve 
input from a controller. 


A character is a type of Pawn that includes the ability to walk 
around. 


A Player Controller is an actor responsible for controlling a 
Pawn used by the player. 


Game Mode defines the qame being played, its rules, scoring, 
and other facets of the game type. 


An ActorComponent is a reusable component that can be 
added to any actor. 


A Scene Component is a component that has a scene 
transform and can be attached to other scene components. 


©) Object 
* 


t @, ActorComponent 
b© alsens 
b) AlSenseConfig 
© AnimMetaData 
b} AnimNotify 
b ©) AnimNotifyState 
© AvoidanceManager 
bO ETNode 
b} CameraModifier 
© CameraShake 
b> ©) DamageType 
© DragDropOperation 
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And as always, ladies prst! Oh, | mean header ples prst. My header ple setup is going 
to be simple, but it is very Important, as much counts on that. 


GameDataTables.h 


Starting with thei nc! ude statements as always, and as you can see, nothing fancy, 
but | have included a new header ple that will allow me to manage the data table, 
which isDataTable.h: 


#include "“Engine/ DataTable. h" 
#i1nclude "“GameFramework/ Actor. h" 
#include "GameDataTables. generated. h" 


Then | started to directly build my structs. Remember the ones we created in 
blueprint? N ow itis the time to create ones in C+. | built two structures using the 
word struct and the macro USTRUCT. 


The þrst oneis called FWeaponStruct , which isthetype of FTabl eRowBase which 
is the equal of data table asset in a blueprint case. Within this struct, I've depned the 
same four variables | used within the blueprint sample, which are: 


A FString Icon 

Å FString DisplayName 
Å int32 Damage 

Å int32 CooldownTi me 


Then, the most important part of creating the struct, is the constructor, which 
basically holds the struct nameF WeaponStruct(), and some default values: 


USTRUCT(Blueprintable) 
struct FWeaponStruct : publicFTableRowBase 


GENERATED USTRUCT_ BODY() 
public: 


UPROPERTY(VisibleAnywhere, Blueprint ReadOnl y) 
FOCENO oon: 


UPROPERTY(VisibleAnywhere, Blueprint ReadOnl y) 
FString DisplayName; 


UPROPERTY(VisibleAnywhere, Blueprint ReadOnl y) 
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int32 Damage; 


UPROPERTY(VisibleAnywhere, Blueprint ReadOnl y) 
int32 Cool downTi me; 


// default constructor 
FWeaponStruct() 


{ 
Icon ="None"; 
DisplayName ="None'; 
Damage = 0; 
Cool downTime = 0; 

} 


ie 


The second part of the code was to create the second table, which is for the missions, 
and is called FMi ssi onStruct . Nothing fancy about it, | used the same concept as in 
creating the previous one, and setting a constructor for it. The only difference here, 
is the variable types and name, as it basically needed to match the signature of the 
Excel sheet (or the. csv plein other words): 


A int32 Kill 
A int32 Collect 


The code is as follows: 


USTRUCT( Bl ueprintable) 


Struct FMissionStruct : publicFTabl eRowBase 
{ 
GENERATED USTRUCT_ BODY{ ) 


public: 


UPROPERTY(VisibleAnywhere, Blueprint ReadOnl y) 
NESZ KELIS 


UPROPERTY(VisibleAnywhere, Blueprint ReadOnl y) 
int32 Collect; 


// default constructor 
FMissionStruct() 
{ 

at i e 

Collect “S05 
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The last part of this class code is generating the actor class body. The point here ts that 
you can't write the structs before the class, which is aC ++ standard; as long as you are 
going to use those structs within the class itself, they need to be depned earlier. 


At the beginning, the class has to be created, and extended from theAct or class, 
which is a default step, and usually it is autogenerated for you, as is the constructor 
and the couple of default methods (begin play andti ck): 


UCL ASS(:) 
class BELLZ API AGameDataTables : public AActor 


{ 
GENERATED_BODY() 


public: 
// Sets default values for this actor's properties 
AGameDataTables(); 


|| Called when the game starts or when spawned 
virtual void BeginPlay() override; 


// Called every frame 
virtual void Tick( floatDeltaSeconds ) override: 


Now, when the game starts, we somehow have to access the tables we have imported 
into the content browser. Which means we have assets which need to access it, but 
there must be a way to do that. 


In fact, here comes the importance of the data structures, so while we have set the 
structures, and been able to import the assets, we can now create aUDat aTable 
property for each table and mark its metadata to allow us to assign it in the 

D etails pane: 


//| used editanywhere, so I'll be able to assign it in the details 
panel 

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Game 
DataTables") 

UDataTable* WeaponsTable; 


UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Game 
DataTables") 
UDataTable* MissionsTable: 
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Then we create an array, TAr r ay , of each data structure type (two for now, as there 
are two tables to be loaded) in order to store all the data from the table within its 
own data structure array: 


// UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Game 
DataTables") 
TArray<FWeaponStruct*>Al | WeaponsData; 


// UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Game 
DataTables") 
TArray<FMissionStruct*>Al!l MissionsData: 


And pnally, creating a method, that will be called, whenever we want to open the 
tables and execute them, which I called OnFet chAl | Tables(): 


UFUNCTION( BlueprintCallable, Category = "Game DataTables") 
void OnFetchAllTables(); 


That's all that we want for the header ple, two structures, and the class. Within the 
class, we need to debne a table property for each table we want to use, and an array 
of the structure type of each table, and pnally a method to access the tables and 
read them. 


GameDataTables.cpp 


As always, thei nc! ude statements come prst, but because my logic does not 
involve anything unexpected and all are normal and typical functions, thei nc! ude 
statements are still the default ones for this class: 


#include "Bellz.h'" 
#include "“GameDataTables.h'" 


You will pnd that the code is split into two main pieces, the default methods and the 
OnFetchAl | Tables() method area. The default methods are left as they are here too. 
By this, | mean thebegin pl ay,tick, and the constructor, are left as the defaults. | 
did nothing with them. So you've got the chance to leave them or delete them. But 

| have left them only because! might need them in the future, especially thebegi n 

pl ay method. 


Also, | was initially going to assign the table assets to this class instance in code, 
within the constructor, but I| found it is easier and involves less typing when we just 
set them in public, and assign them directly in the editor, within the D etails panel. 
So feel free to do what makes you happy with this part: 


// Sets default values 
AGameDatalTables::AGameDat aTabl es() 
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{ 


|| Set this actor to call Tick() every frame. You can turn this off 


to improve performance if you don't need it. 
PrimaryActorTick. bCanEverTick = true: 


} 


// Called when the game starts or when spawned 
void AGameDataTables:: BeginPlay() 


{ 
Super::BeginPl ay(); 


//I|n case | want to call it at the beginning, but the most safe way 
is to call it fromthe outside, probably fromthe player class 
//OnFetchAll Tables(); 


} 


// Called every frame 
void AGameDataTables::Tick( floatDeltaTi me ) 


{ 
Super: TIek( Del tati mi J; 


} 


And now for the huge piece, and where the magic happens, this is the 
OnFetchAl | Tables() method. It is basically running through a tidy and 
ordered process, which makes sense, and it is as follows: 


l. First, | have created anF String and named itCont ext String, and set its 
default value to Name. This will be used for the search. 


2. Starting from this point, we will be coding for theweapons table, and then 
repeating the same thing for any other tables we have. 


3. Then | created an array for the nameTArray<FName> and named it 


weaponsTabl eRowsNames. This is for the prst column of the table of weapons, 
this is used to return the cells names, which means the name of each cell at 
the beginning of each row. These cells have been named as numbers. Later 
we will convert these names to numbers, to be used for looping. 


4. Then werun af or loop with the amount of rows (the total number of 
weaponsTabl eRowsNames array members). 


5. Within each iteration of the loop, convert the number of the row into a string 
name, | ndexString. 
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6. Then convert this string called! ndexString tntoanFName variable type, 
called | ndexString. 


7. The previous two conversions have been made for only one reason, to be able 
to use the method Fi ndRow, which requires an F Name variable to be passed 
through it. Neitheri nt norstring. 


8. Then create a new struct of the weapons struct type, FWeaponStruct (aswe 
are processing the weapons table now), and call itaSt ruct Row. 


9. Assign the current row data, to this newly created struct using 
WeaponsTabl e- >Fi ndRow<FWeaponStruct>. 


10. Finally, assign aSt ruct Row to the array we have created at the header ple, 
the one called Al | Weapons Data. 


11. Now by the end of this loop, the A! | Weapons Data will have all the data of 
the table stored within it. 


After that, do a quick for loop to look within theAl | Weapons Data array, and print all 
its data to the screen. 


Then redo the whole process for any other tables which need to be read and stored, 
which in my case, is one more table for mi ssi ons. And the end result of code will 
be this: 


void AGameDataTables:: OnFetchAl!lTables() 

{ 
//Any will be okay, not necessarily to be this cell name 
Static const FString ContextString(TEXT( "Name" ) ); 


//Get all the row names and store them temporary here, the point is 
to define the amount of rows, the best way yet! 


TArray<FName>weaponsTabl eRowsNames = WeaponsTabl e- >Get RowNames(); 


//usually we used 0 as the start index, but a table have it' first 


row indexed as 1, other wise it will crash 
for (int32i = 1; | <weaponsTabl eRowsNames.Num() + 1; i++) 
{ 


Fotring (ngexString-= FSE From att imt 32) J.) 
FNamel ndexName = FName(*I ndexString); 


FWeaponStruct* aStructRow = WeaponsTabl e- 
>FindRow<FWeaponStruct>(IndexName, ContextString, true); 
All WeaponsData. Add( aStruct Row) ; 


} 
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//GEngine- >AddOnScreenDebugMessage(-1, 2.f, FColor:: Red, 
FString::Fromint( All WeaponsData. Num ))); 


//Just a print to screen to check if | got all the values correctly! 
for (int32 c = 0; c <All WeaponsData. Num); c++) 
{ 
FString message = TEXT(" Number: ") +FString::Fromint(c} 
+TEXT(" Name: ") +All WeaponsData[c]->DisplayName+TEXT(" Icon: ") 
+Al | WeaponsData[c]->lcon +TEXT(" Damage: ") +FString:: From nt( All Weapo 
nsData[c]->Damage) +TEXT(" Cooldown: ") +FString:: From nt( All WeaponsDa 
ta[c]->Cool downT! me); 
GEngine->AddOnScreenDebugMessage(-1, 10.f, FColor::Red, message); 


} 


//Get all the row names and store them temporary here, the point is 
to define the amount of rows, the best way yet! 


TArray<FName>missionsTabl eRowsNames = MissionsTabl e- >Get RowNames() ; 


//usually we used 0 as the start index, but a table have it' first 


row indexed as 1, other wise it will crash 
for (int32 e = 1; e <missionsTabl eRowsNames. Num() + 1; e++) 
{ 


FString IndexString = FString:: From nt((int32)e); 
FNamel ndexName = FName(*I ndexString); 


FMissionStruct* aStructRow = MissionsTable- >FindRow<FMi ssionStruct 
>(I| ndexName, ContextString, true); 


All MissionsData. Add(aStruct Row): 
} 


//GEngine- >AddOnScreenDebugMessage(-1, 2.f, FColor::Red, FString:: Fr 
omi nt( All MissitonsData. Num())):; 


//Just a print to screen to check if | got all the values correctly! 
for (int32 x = 0; x <AIIMissitonsData.Num(); x ++) 
{ 

FString message = TEXT(" Number: ") +FString::Fromint(x) +TEXT(" 
Kills: ") +FString:: From nt( All MissionsData[x]->Kill) +TEXT(" 
Collects: ") +FString::Fromint( All MissionsData[x]->Collect): 

GEngine->AddOnScreenDebugMessage(-1, 10.f, FColor:: Green, 
message); 

} 
} 
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Reading from data tables 


Now we cometo the last part of creating and using a data table within Unreal 
Engine, and it is the most fun part of this process. 


While the book mainly uses C++ in order to build Bellz, | would not only like to 
mention how to make use of the data from C++ code, but also | would like to show 
you how to use it from within a blueprint. Which means data tables are now fully 
supported within both systems. In the early stages of Unreal, using data tables was 
something for C++ users only, but things have changed now. 


As you have seen in the previous section, we were only building the data structures, 
which here represents a form that matches the Excel sheet form, but in a form of 
code. In order to be able to read the data from the bles, we prst need to choose 
which bleto read, and secondly, get the data from it within a loop, usually. 


Reading data through C++ 


N ow for the easiest part of code. Remember Chapter 2, Setting Up Y our Warrior, when 
we built the player controller? There was a variable type of AGameDat aTabl es which 
wenamed Tabi esi nstance within theG! adi ator. h header ble. This will mainly be 
holding all the information we need, or in other words, an instance of what the data 
manager has. This will make it easier every time we need to read or get some data: 


#include "GameDataTables.h" 


Calling theOnFet chAl | Tables() method now is even more easy. | like to do it at the 
beginning of the level, so in each level start, | just go through the data holder in the 
level, and then read all the data at once, and temporarily store it. 


While there are several ways to do it, | usually liketo useTAct orl terator inorder 
to search for all data holders in the map, and then call whatever function | want: 


void AGladiator::BeginPlay() 
{ 


//Ask the datamanager to get all the tables data at once and store 


them 
//AGameDataTabl esdataHol der: 
for (TActorlterator<AGameDataTables>Actorltr(GetWorld()):; Actorltr: 


++Actoritr) 


{ 
if (Actorltr) 


{ 


//print the instance name to screen 
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//GEngine- >AddOnScreenDebugMessage(-1, 10.f, FColor:: Green, 
Actorltr->GetName()}); 


//Call the fetch to the tables, now we get all the datat stored. 
Why? simply because keep readineverytime fromthe table itself is 
going to cost over your memory 

//but the most safe method, is just to read all the data at 
once, and then keep getting whatever needed values fromthe storage 
we've, 

Tableslnstance = *Actorlitr; 

Tabl esl nstance- >OnFetchAl!Tables(); 


} 
} 
} 


Now while we have all the code working perfectly þne, let's just do one more little 
thing to read it. 


As you used to create blueprints based on the C+ code we make, go ahead and 
create a blueprint based on theGame DataTables class, and then drag an instance 
of this blueprint into the scene. That means you have an instance of a data holder. 
| gave minea fancy gizmo, though! 
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Now from the D etails pane! of the blueprint instance, you can select which data 
asset ples are to be used as WeaponsT able and M IissionsT able. J ust set the correct 
ones there: 


4 Game Data Tables 


Weapons Table WeaponsTable 


Missions Table Missions fable 





Now once you hit Run, the expected behavior is: 


A 


A 
A 
A 


As long as there is a player in the map, thebegin pl ay method of the 
Gl adi ator (the player) class, will be executed 


That will allow it to search for any class instance in the map that is a type of 
AGameDataTabl es 


When one is found (the one you just put there), it will call the method 
OnFetchAl | Tables() onit 


This method will go through all the tables, and temporarily save what 
has been found in the tables insidetheAl | Weapons Data array and 
All MissionsData array 


Finally, all the data will be printed to the screen: 





And now anytime you need any data from the table, you just need to access the data 
holder (the instance inside the map) and do your shopping between data! 
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Reading through blueprints 


Reading data through blueprints is even easier, as you can do it using only one node 
call. Unreal Engine has a small section within the nodes list that is composed of two 
nodes only (so far!). It is called D ata Table; you can use either of them to read data 
from a certain table: 


All Actions for this Blueprint Context Sensitive 


Select a Component to see available Events & Functions 


> Actor 

> Add Component 

> Add Event 

b Al 

t Animation 

> Audio 

> Canvas Render Target 2D 

t Cinematics 

> Class 

t Collision 

> Components 

4 Data Table 
f Evaluate Curve Table Row 
J Get Data Table Row Names 

> Debug 

> Development 

t Effects 

> Event Dispatchers 





As there are different types of tables, you can use a different node that pts the 
situation, but in general, you can use the Evaluate Curve Table Row option 
with curve assets 


_J Evaluate Curve Table Row 


[O Row Found [> 


Curve Table Row Not Found [> 
select Asset + 
Dut X¥ Op 
©» Row Name | None| 


Or In xy [0.0] 
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And you can use the Get D ata Table Row Names node with the tables based on data 
structures. J ust like the two tables of Bellz. 


“f Get Data Table Row Names 


D 


Table Select Asset w Out Row Names =: 





You might pnd it easier to read the data through blueprints. It is up to you. Just 
remember that as long as you are creating a C+ project, you are still able to execute 
any amount of the logic through blueprints, as C++ alone will never work, and you 
will need at least 10% blueprints within your project. 


Summary 


After this tasty chapter, you now have a better understanding of data tables 
management within the Unreal Engine environment, and you are able to use any 
type and any size of data table without any problems. 


You've learned what the data table is and what it is used for, and most importantly 
how to prepare one for Unreal Engine. Unreal has its own policies and you learned 
what is going to respect those policies. 


The data table bles you made, regardless of the app, should be converted to. csv,in 
order to convert it to a data table asset. You also learned what the data table asset is 
and what is the different data type assets that you can use. 


A data table is useless without a form, guidelines, and a data structure to follow, it's 
the link between the Excel sheet form and the code. Without a data structure, there is 
a missing pipe within the yow, and you've learned how to build it within C. 


The reason for creating data tables, is to derive some values during gameplay, in 
order to keep it balanced. And while Unreal Engine provides the game developers 
with two different methods of building the game logic, you have learned how you 
can make a use of the data tables you've made and how you can read data either 
within C++ or blueprints. 


Now go ahead, build the tables you want. They don't haveto beweapons ormissions. 
Based on them create some, build their structures, and most importantly, be able to 
read them during the game. And once you are done, you will pnd me waiting for you 
by the door of the next chapter, where we are going to make some N OISE. 
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Ear Candy 


While all games have audio and sound effects mixed with a nice background music, 
a lot of players either mute the game or do not even put their headphones on at 

all! But you can change all of this, if your game idea and its design and concept 
somehow depends on the sound effects, the narrations, and so one. 





What! want to say here is that the audio element Is an essential part of any game, 
and you can not only make it sort of candy that beautibes your game, but you can 
enforce it to be a core element within the game, so that if the player ignored it, the 
experience would not exist. 


Audio types within the game can vary between music or sound effects. Sound 
effects themselves can vary between UI effects, gameplay effects, or voiceovers, but 
whatever the goal that an audio ble is being used for within the game, the process of 
importing the ple and using it within the game is the same, regardless of the audio 
ble format. 


And that's our topic here: audio ples, how to get them into Unreal, and how to make 
the best use of them within the Unreal ecosystem. 


By the end of this chapter, you will be able to: 


Å Import audio files and specify their settings 
Understand the difference between sound assets 
Use the sound cue editor to build some audio cues 


Understand how to use audio volumes, in order to control audio through 
the environment 


Jo oo Do To 


Play sound effects at any moment of your game via C++ code, blueprints, 
notifications, or something else 
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While we havea good set of targets, | would suggest you to go þrst and download 
some free sound effects, music, or even purchase online the ones you want, and 
make a good library of the sound ples that match your game needs. But if you are 
creating Bellz, just like me, then you'll pnd all the sound bles within the book project, 
just migrate them as we discussed in Chapter 1, Preparing for a Big Project. 


6 rqtvpi ‘cw Iq'Orgu 


When it comes to importing an audio ple, it is done in the same way as any other 
type of ble you want to get into Unreal. You could either do it by dragging it into 
the content browser directly or through the right-click menu of the content browser, 
or even by hitting the big Import button in the content browser, just like any other 
asset. But the point here is, the type of audio ples that you can import. 


While all other engines support various types of audio ples, such as*. wav,*. mp3, 
* 099, and soon, not all platforms support the same ple formats. Unreal Engine 
accepts only the *.wav ple, nothing ase. That means if you are trying to import an 
audio ble of type*. mp3 for example, Unreal will not reject it but at the same time it 
will not be considered as an audio ple, and probably will be imported as a movie, 
that you can't neither play nor watch. 


Sometimes you can think of this as a bad thing. But in fact it is a very neat and 
powerful thing, as you have to export all your audio ples, regardless of their usage, 
as*. wav bles, and all of them with the same set of parameters. Regardless of the 
targeted platform, Unreal Engine will work on making those*. wav bles work on the 
platform's beloved format. And this came from the fact that WAV data is saved In 
bulk as PCM. 


And because of that, Epic and the community came up with a specibc export setting 
for audio ples that makes the best use out of the engine, and it is easy to apply in any 
audio application you are using to produce the bles. In general, when you are about 
to export a sound effect or music ble, you have to make sure you apply the following 
settings in your third-party app: 

Å Specifications: PCM, ADPCM, DVI ADPCM 

Å Format:. wav 

Å Bitrate: 16 

Å Speaker channels: Mono, stereo, 2.1, 4.1, 5.16.1, 7.1 
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Channels Mono 
> Advanced 
Bit Depth 

Bit Depth: 


a Ay d Vance d 


Cancel 





And keep in mind that Unreal Engine currently supports importing uncompressed 
little-endian 16-bit wave bles at any sample rate (but a sample rate of 44,100 Hz or 
22,050 Hz is recommended by the Epic team). 


Once your audio þleis inside Unreal Engine, it will no longer be called an audio ple 
but rather a sound wave asset and will be colored in purple. This sound wave asset 
has more settings that you can apply for it, just like importing a three-dimensional 
modal, after getting the ple into Unreal, you can apply some settings and compressions 
for it inside Unreal's model editor. The same applies here, double-clicking on this 
sound wave asset will open the sound wave asset editor, where you can apply some 
compressions, or standard settings for the wave ble. 


bearAttack_001 bearAttack_00?7 
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Once you open the sound wave editor for a certain ple, you can pnd the following 
options adjust them in a way that pts your bles. And yes, you have to do it for 
almost all sound ples you import into Unreal! 


T Details 


O 


4 Compression 
Compression Quality 
4 Sound Wave 
Looping 
a Subtitles 
Mature 
Manual Word Wrap 


Single Line 


spoken Text 


Subtitles 0 elements 


+ 
=i 


Comment 
4 Sound 
Sound Group 
Volume 
Pitch 
Sound Class Master 
4 Info 
Num Channels 
sample Rate 
Duration 
4 Import Settings 


ff f/f. /Users/Muhammad/Desktop/bearAttack_001.wav iim 


source File ni 
2016.02.08-09.58.05 
4 Playback 

Debug 

Max Concurrent Resolution Aule 

Max Concurrent Play Count 
4 Attenuation 


Attenuation Settings 
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Let's look at the settings: 


A Compression: This section has the following option: 


fe} 


Compression Quality: This is a slider for compression versus quality; 
while 1 means the best compression, the maximum value (100) means 
the best quality 


Å Sound Wave: This section has the following option: 


fe} 


Looping: Usually when you play asound using acue, you haveto 
define if it is looped or not. But while there are several ways to play 
a sound, you can set a looping status by default that does not depend 
on a cue. 


Å Subtitle: This section has the following options: 


Oo 


Å Sound: 


(0) 
O° 


fe} 


M ature: The only time you need to set this option tot rue isinthe 
case of adult and/ or mature content. 


M anual Word Wrap: When you are using subtitles for the audio, you 
have two ways to split line breaks, either manually or automatically 
generated. If you don't want the line breaks to be autogenerated, then 
turn on this option. 


Single Line: Setting this option tot rue will display the subtitles asa 
sequence of single lines. 


Spoken Text: What does the audio say? 


Subtitles: | This represents the subtitle cues. If you leave it empty, 
then the previous value will be used. 


Comment: J ust comments for yourself and the other team members; 
probably the localization people will be using this field. But nothing 
here will be displayed to the players. 

This section has the following options: 

Sound Group: Just give your sound file a group to list it 

Volume: The default playback volume for your sound 


Pitch: The pitch amount for the sound; it represents a simple linear 
multiplier to the sample rate 


Sound Class: Choose a sound class that this sound belongs to; you 
can leave it at M aster if you don't have classes in the content browser 
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Å Info: This section has the following options: 


fe) 


fe} 


fe} 


Num Channels: The total number of channels of the multichannel data 


Sample Rate: The cached sample rate for displaying within the editor 
tools 


D uration: The total duration of the sound on seconds 


Å Import Settings: This section has the following option: 


fe} 


Source File: Where are the source files in the disk? 


Å Debug: This section has the following option: 


fe) 


Debug: A useful option you need to set while debugging sound 
issues. It is basically going to display the sound file name/ data as 
long as it is playing, on the screen. But only if you set Stat Sounds 
-debug, from the console variables. 


Å Concurrency: This section has the following options: 


fe} 


fe) 


Override Concurrency: Whether to override the concurrency or not. 


Sound Concurrency Settings: It works only if the previous option 
was set tot rue. And basically this option gives you the chance to 
choose a sound concurrency asset to be used. You can create a sound 
concurrency as an asset within the content browser. 


Concurrency Overrides: If this sound is using concurrency, the 
settings for it will be here. 


M ax Count: Represents the maximum number of allowable 
concurrent active voices for voices playing in this concurrency group. 


Limit to Owner: Set this if you want to limit the concurrency to the 
sound owner (the actor that is playing the sound). 


Resolution Rule: What is the concurrency resolution that should be 
used in case the sound reaches the maximum voice count? 


Volume Scale: Represents the amount of attenuation to apply to each 
voice instance in this concurrency group. 


Priority: The sound priority over other sounds. The higher the value, 
the higher the priority. 
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Å Attenuation: This section has the following options: 


° Ignore Focus: Tells us whether to ignore the focus or not. 


° Attenuation Settings: The attenuation settings asset to be used for 
the sound. You can browse for it in the content browser. 


Now you go ahead, and set the settings you want for all your audio ples. Sometimes 
the default values work well, but at other times you have to set certain options. But 
most importantly you probably will have to visit the settings area to set at least one 
value, which is the volume. 


As you might have noticed in games, each layer of audio has its own volume value, 
and that is something particular to the game and its requirements. This is something 
mostly done by the audio engineers, and while there isn't a working value that pts all 
types of game, Epic games advise developers to use this formula in most cases: 


Å Dialog: 1.4 

A Music: 0.75 

Å Weapons: 1.1 
A Ambience 0.5 


Sound assets 


As you might have seen, many of the settings for a sound ple count on having 
speciþc types of assets. One time, you might need a sound class while at other 
times you might need a sound concurrency, and even more types of assets within 
other situations. 


And that's because the Unreal Engine sound audio system has lots of those assets 

in order to give you the opportunity to get the best out of your audio ble. Not every 
single change within a sound ble needs to be made within a third party; you can 
still make a change in the way a sound ble is heard using those different types 

of asset. 


["4; 5°] 


Ear Candy 


All the sound assets types could be made within the content browser, either from 
the right-click menu or from the big green button called Add New. With any of the 
methods you decide to use, you will pnd all the sound-related asset types listed 
under the Sounds submenu. 


zz; : Dialogue Voice 
= Material ~ J 


m ; |! Dialogue Wave 
+ Particle System ‘aye 3 


di m Media Sound Wave 


Animation 


Blueprints % “¥ Reverb Effect 


Materials & Textures 


Sound Attenuation 


Physics Ea 
= Sound Class 
User Interface f= Sound Class 
Miscellaneous F 
ar Sound Cue 

Blendables ite 
Paper2D i. 
4l? Sound Mix 





Artificial Intelligence 


As you can see there are nine supported types of sound asset ples, the majority of 
them are represent some kind of data structure, where you have to set a bunch of 
options and values, while a few of them represent a logical asset, where you have 
to connect some nodes within a graph. Let's get look at each in more depth, and the 
best usage of each asset type. 


Dialogue Voice 


Dialogue Voice is not actually very useful on its own, as It is a preparation asset to be 
used within a dialogue wave asset. 


Within Dialogue V oice, you can set only two types of information: the gender of the 
spoken dialogue, and its plurality. 


@ Details 
bog s 
m e- 


4 Dialogue Voice 
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Dialogue Wave 


The Dialogue Wave asset is one of the most important sound asset types. With 
the information you make within a Dialogue V oice asset, you can import it inside 
the Dialogue Wave asset in order to use It. This type of asset has its own editor 
responsible for the correlation between the dialogue audio and the subtitle text. 


4 Filter 


Mature 


4 Dialogue Contexts 


Add Dialogue Context 


© Directed At $+ — D 


Sound Wave 


4 Script 


Spoken Text 





Voice Actor Direction 


Media sound wave 


This type of asset represents an implementation of a sound asset from a media player 
asset (a media player asset istheUMedi aPl ayer object, a video, for example). The 
rest of the options and settings you can set for it are then all like anormal sound 
wave asset you've imported. 


7 Details 


a 
search Oaa 
4 Media Player 

Audio Track Index H g) 

Media Player 
4 info 

Num Channels 

Sample Rate 


Duration 


4 Playback 
Debug m 
Max Concurrent Resolution F 
Max Concurrent Play Count 16 o o 


4 Attenuation 


Attenuation Settings 
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Reverb effect 


Within Unreal Engine lots of things are performed inside maps during gameplay 
through volumes. One of those things is sound. While you can have audio volumes 
around your map, you will need to apply settings for those volumes in order to 

play the audio in a certain way or a different tone. And that's where the Reverb 
effect asset is important. With that asset you can depne lots of properties that will be 
applied to any audio inside the volume. 


aq) Details 


Search 

4 Reverb Parameters 
Density 
Diffusion 
Gain 


Gain HF 


cl 
oo 
Wo 
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= 
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Fa 


Decay Time 
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Fa 


Decay HFRatio 
Reflections Gain 
Reflections Delay 


Late Gain 


Fi 


Late Delay 
Air Absorption Gain HF 


Room Rollotf Factor 





Sound attenuation 


Remember that when we spoke about importing sound ples, some settings related to 
sound attenuation? Well, what if you have set those settings for a 100 bles, and, once 
you realize that you have been choosing some wrong options, you want to apply 
some changes to all of them? 


Well, the good news is, you don't have to redo all of them. So you can create a sound 
attenuation asset that holds the options and properties you want and apply this asset 
to the sounds. And at any time you have to make changes, you just do it once inside 
the asset ple! 
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f Detarls 


4 Settings 


4 Attenuation 
Attenuate 
spatialize 
Distance Algorithm 
Attenuation Shape 
Radius 
Falloff Distance 
Non-Spatialized Radius 
Attenuate with LPF 
LPFRadius Min 
LPFAadius Max 





Sound Class 


In the same way you can apply sound attenuation settings to lots of ples at once, the 
Sound Class asset does just the same job, but for a different set of properties. 


4 Sound Class 


a Properties 


| 
Qo 
Fu 


Volume 


LFEBleed 

Voice Center Channel Volume 
Radio Filter Volume 

Radio Filter Volume Threshold 


Apply Effects 


Always Play 


Is UlSound 

Is Music 

Reverb 

Center Channel Only 
Apply Ambient Volumes 
Output Target 


Child Classes 


+ 
E 


Fassive Sound Mix Modifiers 


+ 
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Sound cue 


A sound cue is a place where you can combine audio effects or apply audio 
modibers using sound nodes and create pnal output within an output node. So it is 
basically like a small audio editing app, and the asset is the outcome of that app. It 
uses nodes called sound nodes in order to achieve this result. 


Wave Player : bearAttack_001 


Sos PR 
Output 4 Ne 


Wave Player : bearAttack_002 l 
Add input + 


Output @ 





Sound mixes 


Remember running Winamp in the old days, or even any recent media player that 
gives you equalizers? 


Well asound mix does exactly the same thing: it allows you to set equalizer settings 
and modify the properties of the Sound Class assets. 


i) Details 


Apply EQ 
EQPriority 
4 EQSettings 
HFFrequency 
HFGain 
MFCutoff Frequency 
MFBandwidth 


MFGain 
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of o S © S = 
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4 Sound Classes 


Zi 
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4 Sound Mix 
Initial Delay 
Fade in Time 


Duration 


Fade Out Time 
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Sound cue editor 


The sound cue editor's main job is to make sounds more appealing and creative, by 
applying pieces of logic. The sound cue editor is accessible directly by clicking over a 
sound cue asset. You can have tons and tons of those assets around the project, code, 
logic, and maps, and it is a replaces for directly using the sound wave asset. 


TP Wewsoundcues 


e Edit Asset Window Help 


E © pF a 


Save FindinCB PlayCue PlayNode Stop 
S Details "t= Palette 
4Sound Node 


nE- 
4 j : 
Attenuation Attenuation 


Override Attenu § Branch 
D Concatenator 
Continuous Modulator 
Crossfade by Distance 
4 Sound Crossfade by Param 


Volume Multipli Delay 


Attenuation Set None 


Pitch Multiplier 100060 Dialogue Player 


Sound Class Master ep0 Soe 
nveloper 
4 Playback i Group Control 
Debug 2 P Looping 


Mature 
DESAS ANE Prevent New A 


Mixer 

Max Concurreni 16 0 Modulator 

4 Info Oscillator 

Duration Quality Level 
Random 
SoundClass 
Switch 
Wave Param 
Wave Player 
Add Comment.. 





Then what is the difference between using this asset type and the sound wave? 


Well, you can apply some parameters, randomizations, and much more. But the most 
common reason to use the sound cue asset is to apply randomization to assets. So 
let's give an example from Bellz, and then you can just follow the recipe, improvise 
with different sound nodes, and you'll get great results! 
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When a bear is attacking, there are several audios being played. But, as you can see, 
used several nodes, in order to make It sound unique each time. 


Wave Player . bearAttack_001 
eueue 3 

“Wave Player . bearAttack_002 
Output @& 

Wave Player : bearAttack_003 


Output @ 


“Wave Player : bearAttack_004 
Output @ a a O S SS 


Wave Player bearkttsek 005 a eyes =a 
Shine 2 $ 


“Wave Player . bearA 006 ee 
Output @ 


“Wave Player : bearAttack_007 
Output e 

Wave Player : bearAttack_008 
Output 4 

“Wave Player . bearAttack_009 


Ei 
om gee 
a 


"Wave Player : bearAttack_010 i a D 
Output @ e 
“Wave Player : bearAttack_011 
Output & 
“Wave Player. bearAttack_012 
Output @& 





| used the following options: 


Å Random: In order to choose a different sound file randomly every time 


Å Modulator: In order to apply a different volume or pitch modification every 
time the sound plays 


Å Mixer: In order to play different sounds together 
Connecting all these to the output will result in a different these every time. Try to 
keep playing and pausing from the top bar controls, and you'll hear it. And that's 


about it the sound cue editor; just make variations and try to make the sound play 
uniquely every time. 
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Audio volumes 


Audio volume works like any other volume within Unreal Engine, which means it 
reoresents a type of effect that takes place inside the bounds of that invisible volume. 


You can pnd the Audio Volume actor in the same place as all the other volumes, 
which means under the Volumes section of the M odes panel. Alternatively, you can 
just create a brush and convert it to an audio volume as we have done several times 
during Chapter 3, Designing Y our Playground. 
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After inserting the audio volume, all that you can do is either position it, scale it to pt 
the area of effect, or set its parameters. While the audio volume contains some of the 
standard parameters that are found within any other volume, such as the Transform 
settings, Brush settings, and Actor setting, there are another three major sections of 
settings that give this volume its personality. 


4 Audio Volume 
Priority 
Enabled 
4 Reverb 
4a Settings 
Apply Reverb 
Reverb Effect 
Volume 
Fade Time 
4 Ambient Zone 
4 Ambient Zone Settings 
Exterior Volume 
Exterior Time 


Exterior LPF 


None 


Exterior LPFTime 


0.5 a” 


Interior Volume 


dl 
oa 
Fu 


Interior Time 
Interior LPF 


Interior LPFTime 


gr 
[=] 
Fu 





They areas follows: 


Å Audio Volume: This section has the following options: 


° — Priority: If this volume overlaps another, this value will define its 
priority over the other 


° Enabled: Define if this volume works or not 


Å Reverb: This section has the following options 
° Apply Reverb: Define if the reverb effect works or not 


° Reverb Effect: You have to browse for the Reverb effect asset from 
the content browser, the one that has the parameters you want to use 
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° Volume: The volume level of the Reverb effect 


° Fade Time: The amount of time used to fade the currently active 
Reverb settings into those held by this volume 


A Ambient Zone: This section has the following options: 


° Exterior Volume: The required volume of sound outside this volume 
when the player is inside the volume 


° Exterior Time: The amount of interpolation to apply the previous 
volume value (Exterior Volume) 


° Exterior LPF: The required frequency cutoff (in Hertz) of sound 
outside this volume when the player is inside the volume 


° Exterior LPF Time: The amount of interpolation to apply the 
previous value (Exterior LPF) 


° Interior Volume: The required volume of sound inside this volume 
when the player is outside the volume 


° Interior Time: The amount of interpolation to apply the previous 
volume value (Interior Volume) 


° Interior LPF: The required frequency cutoff (in Hertz) of sound 
inside this volume when the player is outside the volume 


° Interior LPF Time: The amount of interpolation to apply the previous 
value (Interior LPF) 


N ow that you totally understand all the parameters that you can set, go ahead and 
throw some audio volumes within your environment and keep testing them, to see 
how it looks and feel when you hear the audio in different ways within a specifpc 
area. The best practice would be if you havea cave in your map; an audio volume 
will work just great there with the correct values for the parameters. 


Playing sound effects 


When it comes to playing any type of sound, Unreal gives you more than one 
method and you have to pick the one that pts you and the situation of that sound. 
The most common and popular methods I've found are: 


Å Through C ++ code: You can play the sound of any Audi oComponent, by 
simply using the member function P|! ay() and, yes, just one line to run 
a sound. 


AudioComp. Play(float StartTi mer): 
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Å Through blueprint nodes: Within a blueprint you can simply play sound 
using any of the Play Sound nodes. You can play a 2D sound, which means it 
will have the same volume always, or play it at a location in order to fade the 
sound in and out while getting closer or further away from it. 


T Play Sound 2D 


i 
# 


Sound 
Select Asset 


J Play Sound at Location 


Sound 
Select Asset 


_ Location ite 
' [x oolly o0]|z 0.0] 


¥ 





Å Through animation notifications: J ust as we used to set an animation 
notification to call some parts of the code, in the same way you can add 
a notification of the type PlaySound and it has its own options within 
the notifications menu. 


|, a | lll 


PlayParticleEffect 


Add Notify State... > 


Manage Notifies... New Notify 
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After adding it, selecting the notification itself, will give you a set of options 
at the D etails pane! for that specific notification, which will be mainly to 
choose a sound or sound cue to be played among other sound properties 
that you are already familiar with right now. 


4 Anim Notify 
Notify 
VolumeMultiplier 
PitchMultiplier 
bFollow 


AttachName Bone Name... 


Sound bearAttack_0O027 
b Notify Color E 


4 Trigger Settings 


Notify Trigger Chance 
Trigger on Dedicated Server 
Notify Filter Type No Filtering " 





Å Drag and drop: By dropping any sound wave asset or sound cue asset inside 
the map, it will run directly as soon as the game starts, and | guess this 
method only works well with ambience. 





While there is no specipc method to play sounds, you have all of them at hand. 
Depending on the situation, you can decide which one to go with. Sometimes 
you'll haveto bre it from the logic itself, either C++ or blueprints. But other times 
it is better and more accurate for it to be tied with the animation frames, or even 
throwing it into the map might get the job done. It is up to you and the goal of 
that sound! 
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Summary 


Congratulations, you have just learned the necessary tools and techniques to be 
a noisy games developer. Games without audio makes for a bad experience; the 
minimum amount of audio and effects is essential to deliver an experience. 


Regardless of the usage of an audio ble, you have learned all the properties that you 
can tweak for a sound wave ble. Whether it is background music, dialog, or effects, 
it doesn't matter. All of them share the same properties at the end of the day. 


Of course Unreal Engine has a wide range of sound assets, a really wide range. Each 
has its own job, but all of them are here to allow you to be productive and give you 
the chance to control the tiniest detail that might be heard. 


Sound cues are an amazing solution. Lots of other engines make you write your own 
tools to modularize the same set of sound bles you have, but with the sound cue 
asset and its editor, it becomes very easy to modularize a small amount of sounds 
and shufye between them in order to make variations. 


Sometimes the visual experience has more impact than sounds, and you learned how 
to use the audio volumes and what parameters to tweak, in order to give each area of 
the map its own personality. 


Playing a sound can be tricky; there are different methods that you can follow to play 
a piece of sound, but it all depends on the situation, and you have learned about the 
four methods provided by Epic. 


Now, go ahead, be noisy, and add some ear candy before moving on! 
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Performance 


Once you have completed the gameplay section, and you havea game ready to be 
built and shared with players, you have to spend some time making sure that the game 
IS as free from issues as possible, and its performance is well balanced, with no frame 
rate drops, no glitches, and most importantly no crashes. 


The debugging and propling phase might take too long, it depends on how you 
have constructed your game, and how much care you gave earlier to the game code, 
blueprints, and graphical and rendering items. A major part of the debugging is for 
the code, but this is atypical debugging via Visual Studio which you are already 
familiar with, and debugging code here works the same as it does anything else. 

But the parts we are going to focus on during this chapter are the ones that could 

be made directly through the editor itself. 


Of course, there are a lot of propling tools and performance analyzers out there, but 
the majority of them are paid tools, and not that cheap. And here comes our super 
hero, Epic, with its amazing set of tools, that areas free as the engine itself. Epicis 
doing a great job with the Unreal ecosystem. There are a lot of tools and editors within 
Unreal that are used to serve different jobs and tasks while you are optimizing and 
freeing your game from bugs, and that's what we have to do right now. 


By the end of this chapter, you will be able to: 


A Understand how to debug blueprints in the editor using the blueprint 
debugger 
Å Usethe collision analyzer and understand its job 


Å Usethe editor and game console commands 
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Å Create FPS charts and read them to analyze the game performance 

Å Switch between the different view modes and the visualizers to define the 
rendering performance Issues 

Å UsetheGPU visualizer 

Å Understand the device manager and the importance of the device profiles 


While we havea huge table of targets, let's get started and launch the game editor. 
One thing to keep in mind while we are debugging is that the majority of the editors 
and tools are always listed under the Window menu at the D eveloper Tools section 
as depned in the following screenshot: 
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Box Trigger aye 
I9 ga Device Manager 
4%] Device Profiles 
Sphere Trigger Ct conn per 
p gq W Session Frontend 
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The blueprint debugger 


Debugging code is a process which usually involves using breakpoints inside the 
IDE (which is Visual Studio here), but what if the game logic, or even parts of it 
have been made in a form of blueprints, then how could we debug those parts? 


Well, Unreal Engine supports breakpoints for the blueprints logic as well, and that 
makes it easier to debug any graph-based logic. You can simply add a breakpoint 
to any node within a blueprint by simply right-clicking over the node, and choosing 
Add Breakpoint. It will be represented by a red circle at the top-right corner of 

the node: 
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F Add Controller Yaw Input 


i 
F 


Target [self] 


— @ Val 





Later, this choice will be replaced by a few other ones such as: 


A Remove Breakpoint 
Å Toggle Breakpoint 
Å Disable Breakpoint 
As expected, once you run the game, and the logic is about to execute the node that 


holds the breakpoint, then the game stops, and Unreal launches the blueprint for 
you, with the node highlighted: 


Target | self | 





That's one way of using the breakpoints. And it is a great thing to do! However, 
when we debug the code via breakpoints, we can do a stack track as we would in 
a code breakpoint within Visual Studio. Which means we can follow its roots: The 
method, action, event, or node called before we call the node with a breakpoint. 
And the thing before that thing, and so on. Wecan keep tracking the whole 
sequence of logic. 
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That's exactly the usage of the blueprint debugger. Once you have the game paused 
because of a breakpoint, you can directly open the blueprint debugger, and there 
you'll bnd the Execution Trace point of that breakpoint: 


on | an ae | 


Resume FrameSkip Stop Find Node Step 


Showing debug info for selected actors 

Name Value 

4ThirdPersonExampleMap1 

No debugging info 

4 Execution Trace 
‘Add Controller Yaw Input ThirdPersonCharacter_l67@ 676.87 s 
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Reading this trace is exactly like how wedo it in C++ and Visual Studio. You can keep 
tracking, reading values of the different variables until you spot the location of the 
problem. And, as with any other debugging tool, the blueprint debugger gives you the 
same set of buttons you pnd in something like Visual Studio or Xcode, which includes: 


A Resume 

Å Frame Skip 

Å Stop FPS Chart 
Å Step 
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So if you have a logic error or bug that is related to a blueprint logic, then go ahead 
and throw some breakpoints at the suspicious locations and pre your blueprint 
debugger to do atypical tracking as you would do with Visual Studio. And 
remember, clicking on any part of the trace will take you directly to the responsible 
nodein your blueprints, just like atypical code trace, but let's call it a node trace! 


The Collision Analyzer 


The only case where you might need to use this editor is when you have collision, 
overlapping or hitting events problems. As you can see from the tool name, it is all 
about and for physics collisions. 


One of the most interesting things about this tool is it is very easy to use, and itis 

a tool that could be used at any time of the project development. Which means you 
can use It in the Edit mode while building your game, or while the game is running 
via the Play In Editor (PIE). Any time you hit the Record button, the tool will serve 
you directly: 


‘u PESE Analyzer 


on 


D Frame Type Shape Tag Owner 
4 4 


t T 


Start: § Show Misses 
End: 


Time Type Component Normal 


Total: 0 queries over 1 frames. Shown: 0 queries 





Once you hit Record, and let's say it's at runtime, the tool will start recording all the 
collisions that happen in the game, regardless of how weak or powerful they are, and 
regardless of whether they are at the camera view or not. Any single collision taking 
place will be recorded. Once you feel you're done, you can just hit the Stop button. 
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The result you have is very important, as you can understand what collisions have 
taken place, and what were the parties of each collision event, and which class or 
blueprint is responsible for that, and, most importantly you can learn about the time 
spent and the hit or collision times in a single frame. 


Sometimes physics goes weird, and an event or hit registers twice; you have no way 
that you can catch it and understand the reason, except by using Collision Analyzer. 


One of the coolest things that you can learn about your game collisions ts that, 
when you choose any of the recorded collisions from the list, they will show you 
the exact position where this collision took place, and the exact position where 
the collision ended! 


O o 
iD 7 Frame Type Shape Tag Owner #B 
(i: as: es : 
| + + + 
BAT Single Capsule ComputeFloorDistSweThirdPersonCharacter_] 
B47 Single Sphere  SpringArm ThirdPersonCharacter_O 
B48 Single Capsule ComputeFloorDistSweThirdPersonCharacter_| 
B48 Single Sphere  SpringArm ThirdPersonCharacter_0 
849 Single Capsule ComputeFloorDistSwedhirdPersonCharacter_1 
849 Single Sphere  SpringArm ThirdPersonCharacter_0 
650 Single Capsule ComputeFloorDistSweThirdPersonCharacter_] 
Single Sphere = SpringArm ThirdPersonCharacter_0 
le Capsule ComputeFloorDistSweThirdPersonCharacter_1 


nan n om on 
— oon fe wha e 
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Single Capsule ComputeFloorDistSwedhirdPersonCharacter_1 
Single Sphere  SpringArm ThirdPersonCharacter_0 
Single Capsule ComputeFloorDistSwedhirdPersonCharacter_1 
Single Sphere SpringArm ThirdPersonCharacter_0 
Single Capsule ComputeFloorDistSwedhirdPersonCharacter_] 
Single Sphere  SpringArm ThirdPersonCharacter_0 
Single Capsule ComputeFloorDistSweThirdPersonCharacter_] 
Single Sphere  SpringArm ThirdPersonCharacter_0 
Single Capsule ComputeFloorDistSweThirdPersonCharacter_] 
Single Sphere  SpringArm ThirdPersonCharacter_0 
Single Capsule ComputeFloorDistSweThirdPersonCharacter_1 
Single Sphere = SpringArm ThirdPersonCharacter_0 
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Time Type Component Normal 
0.143 Block Invalid X=-0.000 ¥=0.000 2=1.000 


Total: 2.734 queries over 944 frames. Shown: 2,734 queries 
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Also, the analyzer gives you a total of the collisions that took place at the time of 
recording, which means that you can understand out if you have more collisions 
than you should have or not, and again you can start working on that. 


In anutshell, the tool records everything for you, but what to do with the recorder 
results? It is something back to you and your needs. If you don't know yet why you 
need some results, then no problem, you can hit the Save button to save it in a form 
of a* UCA ple, and you can open it later using the same tool! 


The console 


Any version of the Unreal Editor, or any game built with Unreal Engine, could have 
a console within it. This console has tons of variables that you can turn on or off, 
sometimes to display stuff, and other times to just hide something away. 


If you don't know how to display the console, it is usually done using the input key 
` for any game or any other game engine, and that's the default button for it within 
Unreal Engine, but you can change it in Input Settings of Project Settings. 


Unreal Engine provides a number of console variables, which could be used at 
runtime in order to debug the game. However, some of those console variables are 
called show yags, which are implemented therein order to allow you to toggle a lot 
of rendering features at runtime. But that is only in the executable builds; in edit time 
(inside the editor) it is even easier, as the editor is a convenient place to have lots of 
menus and buttons, The Epic team puts them in one of those menus, which will be 
discussed later in this chapter in the The view modes and visualizers section: 
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In the game, you can use the Show command. Use the Show command to get a list 
of all show yags and their states. Uses howf | agname to toggle a feature. 


All the show yags are exposed as console variables, for example the console show 
bloom, showf!ag. Bloom 0 orinconpguration*.ini files: showflag. Bloom = 0: 


È t i ù 


DefaultEditor.ini DefaultEngine.ini DefaultGame.ini Defaultinput.ini 





Keep in mind that some features will consume performance even if the feature is not 
enabled and not rendering anymore! Yeah, | Know it sounds silly, but, for example 
disabling the show yagshow particles will hidethe particles. The particles are 
hidden, but simulation time is still running in order to make the particles work 
properly when re-enabling them at a later time! So, it is not rendered, but it still 
calculates for the possibility of enabling it again. It is not the only example, but 
there are tons of other things that are disabled, but unfortunately are still running 
underground. 


The FPS charts 


The console is not only made for immediate toggles or displays or even an 
immediate value change. Using console commands such asSt art FPSChart and 
StopFPSChart will allow you to generate a performance chart over a period of time: 


@g.e 


-2016.02.09-11.37 UEDPIE_O gameL UEDPIE_O garneL UEDPIE_0_ gameL 
0-FPS-Windows evel-FPS-Windo evel-FPS-Windo evel-FPS-Windo 
html WE CSW wshtml ws.log 
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Using such a command will generate a*.csv pleintheProfiling folder which is 
located atProjectFolder]\Saved\Profiling\SubwayPatrol\FPSChart Stats) \ 
[Date of today]\. 


Then you can easily load that*. csv ple with Excel or any similar app. Then you can 
check the values you want which is very straightforward. Once you open the plein 
Excel, just mark the cells you want to visualize, and create a chart for it: 


Insert Chart 


Recommended Charts All Charts 


rs HO LBA AB io 98 108 iso 


Column 
T Clustered Column 


REE 5 


P 
[i 
E 


Pie Chart Title Chart Title 
Bar 

Area 

XY (Scatter) 

Stock 

Surface 


Radar 


=y 
kA 
E 


Treemap 


Sunburst 
Histogram 
Box & Whisker 


Waterfall 


PLERFG 


Comba 
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It might be a very useful step to get the stat unit times over a period of time where 
you suspect some performance issues: 


Chart Title 


E Percentile WFrame (ms) Æ GT (ms) m RT (ms) Ææ GPU (ms) 





The*. csv þleis not only what you get, but it is the most important one. You also get 
a*.l| og þlewhich contain lots of useful information along with two tables of HTML 
bles that hold some more info about the frames. And everything mostly named with 
the map/ level name: 


~~ ome in i's Cyl Aa = ae 
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The view modes and visualizers 


The view modes are one of the easiest ways in Unreal Engine that you can use to 
isolate some behaviors. They look like just a combination of show yags within the 
editor UI, but they hold much of Unreal's power. And they are almost the same as 
the show yags we discussed previously that can usetheVi ewMode console command 
to switch between them (check the previous paragraph, if you have already 
forgotten). But their job is limited to displaying some of the pnal picture aspects, or 
even the full pnal picture. As you know, the result you see on screen is basically a 
combination of different kinds of layers, and here you can separate them! 
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|= Lit 


-= 
Pu 


Wireframe 
| 
le Detail Lighting 
1 


# Lighting Only 


*® Light Complexity 
Shader Complexity 
Stationary Light Overlap 

@ Lightmap Density 

4 Reflections 

E LOD Coloration 


Buffer Visualization 





As you can see, their names imply what exactly you should expect on switching 

to one of them. For example, the Reyections view mode will help you to easily see 
and focus on the reyections only. Another benebt is that you can use the shortcuts 
as depnes to make your workyow even faster; just hold the AIt, and keep swapping 
between numbers to have a look over all of them quickly. | do it that way! Some of 
the most important view modes are: 


Å Unlit: This view mode shows the diffuse color of the surfaces without any 
lighting or shadowing effects: 
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Å Wireframe: This view mode shows the wireframe of all the meshes within 
the map (static, skeletal, or even brushes or decals), and it is quite helpful 
while optimizing: 





Å Light Only: This view mode shows the light data only, just light and 
Shadow. It is the total opposite of the Unlit view mode, where we see 
diffuse colors only without shadowing: 
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Å Lightmap Density: This view mode displays a color code, where the green 
color means the meshes or parts have the normal light maps resolution (texel 
density). The blue color means this resolution is less and the red color means 
itis high: 





Å Reflections: This view mode will make everything you see within the map 
as reflective, and then you can study the reflectivity around the map, which 
makes it easy for you while placing the reflection capture actors: 
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And that's not all the list, even by the end of thelist, you pnd an extendable list 
called Buffer Visualization, where you will bnd more options to visualize. But keep 
In mind that it is different, which means it contains more options. Feel free to keep 
Investigating them all, but in general, that's what you are going to pnd in the menu: 


ey Player Collision 


& Visibility Collision 
andscape 

Visualizers 

LOD 


Exposure 





Overview 


Base Color 

Custom Depth 

Custom Stencil 

Decal Mask 

Final Image 

Shading Model 

Material Ambient Occlusion 
Metallic 

Opacity 

Roughness 

Scene Color 

Scene Depth 

Separate Translucency RGB 
Separate Translucency Alpha 
Specular 

Subsurface Color 

World Normal 

Ambient Occlusion 

Custom Depth World Units 


Scene Depth World Units 


Generally, using the Overview choice has always been my favorite in order to get an 
overview of the most important buffers and compare the results in real time: 
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At the same time, there are visualizers, which are almost the same as the view 
modes, but serve different purposes and display different results. The visualizers 
are there in order to enable you to debug or view what Unreal is doing behind 
the scenes! 


(_| Adaptive Depth of Field 
Advanced [| Bloom 
Editor C] Depth of Field Layers 
Volumes C] Distance Field Ambient Occlusion 
Layers |_| Distance Field Global Illumination 


Sprites (| HDR (Eye Adaptation) 


Foliage Types |_| Light Propagation Volume 


[CI Mesh DistanceFields 
IC Motion Blur 

_ | Out of Bounds Pixels 
| _| Precomputed Visibility Cells 
if] Preview Shadows Indicator 
O Sereen Space Reflections 


[C] Subsurface Scattering (Screen Space) 





| Volume Lighting Samples 


The visualized modes could be rendering steps or paths like the depth pass, or 
specialized views, like the motion blur vector visualizer. And, while the view modes 
allow you to display one at atime, the visualizers allow you to display different 
amounts of options at the same time. The view modes' UIs were built based on the 
toggle buttons while the visualizers' Uls were built using checkboxes. While some 
of the visualizers will display only a result for you, others will be displaying lots of 
useful statistics too. For example, the Depth Of Field (DOF) visualizer: 
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The GPU visualizer 


The GPU visualizer is the place where you can see a visualization of each unit 
performance within the GPU. As you might know, the GPU has many different units 
working in parallel in order to do all the requested calculations. But sometimes some 
of these units hit their bounds, and can't process any more or any faster, and here 
comes the lag and performance issues based on the rendering pipeline. It is common, 
by the way, and it doesn't mean your content is that bad, but you can be bound by 
different units for different parts of the frame every day with the most complex and 
at the same time with the simplest projects! 


But using the GPU visualizer will allow you to look at the parts where there is 

a bottleneck, and then you would know exactly what needs bxing. Because the 
visualizer is not embedded inside the editor UI by default, we have to launch it 
through the console (the same way you did before for the show yags), but this time 
you need to display the editor console not the game console. It is donein the same 
way, by using the console shortcut while being focused on any of the other editor 
panels, it will pop up the editor console for you. Just input the command name 
r.ProfilerGPU. ShowU! and it will appear: 


r.ProfileGPUu. ShowlI 


HEGE ©. protileGPuU.Showwl 
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One thing to keep in mind, for some reason it might not appear on Mac editor builds. 
But it is okay with Windows editor builds. Also sometimes it might cause you some 
performance lag, but that is quite normal as it is based on slate (the UI solution used 
to build the editor UI) which is rendered in the GPU and needs to be updated every 
frame in order to display the correct results for you: 


AL GPU Viewalizer 
TA FRAME\Scene 


RasePass 


BeginOcclusionTests 


LightCompositionTasks_PreLighting 
b Lights 

FinishRenderingSceneColor 

b Translucency 


PostProcessing 





Scene Leaf Events 


Zoom: 1.00x $$$ 


Name Duration (ms) 
InitViews 0.00 
ClearLPVs 0.00 
BeginRenderingSceneColor 0.02 

> BasePass 0.23 
ResolveSceneDepthTexture 0.00 
HZB SetupMip 0 1024x128 0.02 
HZB SetupMips 1..9 512x64 Mips:0 0.07 

> BeginOcclusionTests 0.00 
ResolveSceneColor 0.00 
RenderVelocities 0.05 

> LightCompositionTasks_PreLighting ZiT 
ClearStencilFromBasePass 0.01 
ClearTranslucentVolumeLighting 0.06 

t Lights 0.26 
FilterTranslucentVolume 48x48x48 Cascades:2 0.26 

> FinishRenderingSceneColor 0.00 
ResolveSceneColor 0.00 
ScreenSpaceReflections 1051x152 0.07 
ReflectionEnvironment ComputeShader 1051x152 Tile:16x16 Box:0 Sphere] ClearCoat:0 0.17 
CompositionAfterLighting 0.00 
BeginRenderingSceneColor 0.00 
Atmosphere 1051x152 0.09 
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While everything is calculated in milliseconds (ms), you will be able to easily deþne 
what causes much time to be rendered and therefore you can start checking the 
reason and optimize it. There is no key solution that the GPU visualizer will provide 
to you in order to px your bottlenecks, but it will lead you in the right direction by 
letting you know what takes more than usual during the frame. 


The Device Manager 


The Unreal Device M anager, is nothing more than a device manager! 


In fact, this tool has not that much to do with either development or probling, but 
knowing it might be useful, especially when it comes to building the game in the 
next chapter, where you have the chance to deploy it directly to a device: 


u e Maneder 


Window 


Platform Filters ~ $ 
Device Platform Status Claimed By 


DESKTOP-8S5GMJ9 Windows Connected Muhammad 


A 
© Firefox HTML5 Connected Muhammad 
a 


All_IOS_On_DESKTOP-8S5GMJ9 iOS Connected Muhammad 


p Add An Unlisted Device 


fF Running Processes fF Wevice Details 


Please select a device from the Device Browser Please select a device from the Dev 
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The Device M anager gives you the chance to add devices to the Unreal environment; 
any type of device that can be connected to your PC is acceptable. It also allows 

you to read some information about the selected device, check a list of the running 
processes, and even shut it down or restart it if you want. 


The most important part here is when you have a device which doesn't know if itis 
supporting a certain feature of the engine, then you can simply connect the device, 
and add it to thelist. You could check the D evice D etails section of the Device 

M anager to learn about the supported and unsupported features on that device: 


J” Device Details 
Name: 
Platform: 


P Operating 
T Device ID: 
r Default device: 


Status: 


Feature 
AudioStreaming 
DistanceFieldShadows 
GrayscaleSRGB 
HighQualityLightmaps 
LowQualityLightmaps 
MultipleGamelnstances 
Packaging 
SdkConnectDisconnect 
Tessellation 
TextureStreaming 


Sen. egentals 


VertexShaderTextureSampling 
MultiLaunch 

PowerOff 

PowerOn 

ProcessSnapshot 

Reboot 
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system: 


Available 
Yes 

Yes 

ho 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

hyo} 

Yes 
Yes 
etl 
Yes 
Yes 


DESK TOI 
Windows 
Windows 
Windows 
yes 

Connecti 
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When wetalk about scalability and extensibility in game engines, Unreal is really 
the master! N ot to mention the amount of settings and options you can do for the 
different platforms, but here at Device Proples, you can do even more detailed 
tasks In no time: 


uU eee 
A EA SUNG DEVICE EOE {a The default device profile configuration is under Source Control. This file is currently v 
Name 
| Windows Window 
WindowsNoEditor 


WindowsServer pas 
os Windows ‘Windows 


iPad? WindowsMoEditor ‘WindowsNo Windows 
iPad3 WindowsServer ‘Windowsse Windows 
Pada IOS los 
‘PadAir iPad2 lios 0S 
| iPadMini iPad3 (10S los 
iPadMini2 iPad4 108 IOS 
iPadMiniA iPadAir 10s 10s 
iPodTouchs iPadMini | los los 
iPhone6 iPadMini2 108 iPadAir 
iPodTouch6 iPadMini4 108 iPadMini2 
iPhoned iPodTouch5 los los 
iPhone4s iPhone6 10S IOS 
Kise iPodTouch6 jos iPhones 
monens iPhoned 10s IOS 
iiini iPhoneaS 10s IOS 
Eune iPhones 10s |OS 
iPhone6SPlus | | 
iPhones 10s los 
G Create A Profile... iPhoneGPlus 10S ios 
Profile Name: iIPhoneés 10S IPhoneb 
file name iPhone6SPlus 10S iPhone6Plu 
Profile Type: \PS4 
Choose a device profile type... ~ / xhoxOne 
Select a parent: 'HTML5 
DOF pertes fre ‘Mac 
MacNoEditor ‘MacNoEditc Mac 


Name Device Type Base ProfiletCVars Texture LODE 


hi 


NSN 





ST 





NNNSNN 


Z| 





DD 
DS 


Niy 
i‘ 





NSSS 
DNNN 


` 


Ie | Se] Se) S|) 
NINNIN 


S 


Niy 
NINS 


~ 
S 





Let's say your game is going to be shipped for all consoles that is supported by 
Unreal Engine, and that includes mobile devices, and let's even be more detailed and 
say it will be supporting all the available iOS devices. So what size of textures would 
you put in the pnal game* i pa? 
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Here comes the power of Device Proples, Unreal gives you a huge list of platforms 
that you can mark as included or not via the pin next to the name of each one: 


Windows 
WindowsNoEditor 
WindowsServer 
lOS 

iPad? 

iPad3 

iPad4 
iPadaAir 
iPadMini 
iPadMiniž 
IPadMini4 
iPodTouchs 
iPhone 
iPodTouch6 
iIPhoned 
iIPhone4s 
iPhones 
IPhoness 
iPhone6Plus 
iPhones 
iIPhone6SPlus 
PS4 
AboxOne 
HTMLS 

Mac 





Try to unpin any of the proples from the left side and you'll see them being removed 
from the table at the right. 


Once a device is pinned, and included, you have the chance to set different settings for 
it through Console Variables and/ or Texture LOD Settings. For each device, you can 
just hit the Tool icon, and then you can set the settings you want per device type: 
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The window of the settings looks the same for all platforms, but once you start doing 
changes per platform or per device, the window will look different each time you open 
it for a device. And remember, you can always rename the device prople with a name 
of your choice by changing the value of the base prople name from the proples table: 


AL $ Windows 


ail 
[ 


al 


Parent Device Profile 
Selected Parent: 


Console Variables 


Uncategorized $ DÑ 


An i a i 
Physics s ii| 
Network +" gj 
Console $ Qj 


Compatibility $ F 


User interface +r P 


Texture LOD Settings 


> World 
> WorldNormalMap 
> WorldSpecular 


al 
[ 
[ 
Ç 
É 
[: 
[ 
Ç 
[: 
[ 
[ 


Character 


> CharacterNormalMap 
> CharacterSpecular 

> Weapon 

> WeaponNormalMap 

> WeaponSpecular 


> Vehicle 





And while Unreal gives you all the possible proþles that you could think of, you 
still have the choice to add even more proples by simply setting Proble Name and 
choosing Propble Type and hitting Create Proble: 


a) Create A Prone... 


Profile Name: 

Enter a new profile name... 
Profile Type: 

Choose a device profile type... 


Select a parent: 
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Summary 


Now you have done a great job, and l'm sure you found a few things to tweak in 
your game, as | did with mine. As you know, there is no perfect content, and there 
IS always something to change, update, or bx. 


While debugging is usually done within the IDE, which is Visual Studio in our 
case, the code debugging is not everything when it comes to Unreal Engine, and 
you've learned about the different tools that are provided by Unreal in order to 
cover that aspect. 


Now you understand the blueprint debugger, and while our game is a C++ game, 
we still have few blueprints to debug and check whether there are some errors in 
them. Collision Analyzer is a good place to spend some time, but only if you are 
facing some physics engine problems. 


Some games have consoles, but any Unreal game by default has a very powerful 
console, and you learned where to get it and why, and what you can do with it. 


If the game frame rate has a problem, then there is nothing better than using the 
console to generate some FPS charts and then loading them within something like 
Excel in order to convert the generated number tables to something visual and 
understandable. 


Sometimes rendering behaves weird; turning on and off some features comes in 
handy in those situations, and you learned about the view modes and the visualizers. 


D evice M anager and Device Proples are two extra tools enbedded within Unreal. 
They are not very popular, but both are necessary to make sure the game is as good 
and smooth on the end user's device as it is on yours. 


Now that you have learned a lot of things, | would suggest you to go ahead and run 
through all the tools once without looking at the book, just to make sure you can use 
them on your own without a reference, and once you are ready and satisbed enough, 
go ahead to the next chapter, where you will pnally be porting the game! 
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Packaging the Game 


Now wecome to the most interesting part of this book, and the most interesting part 
in the journey of developing a game. It's time to put everything together into a game 
ble that we can ship and share without the need to have the editor or the engine itself 
in the end user machine. 


This seems to be the end of our journey, but hang in there! If the game you have 
built/ are building is meant to be a real game, which needs to be released for players 
and distributed to vendors, then it's just the start of another journey! 


A game is not just an art, code, and a game design packaged within an executable. 
You have to deal with stores, publishers, ratings, console providers, and making 
assets and videos for stores and marketing, among other minor things required to 
fully ship a game. 


Apart from that, this chapter will take care of the last steps you need to do within 
the Unreal environment in order to get this packaged executable þne and running. 
Anything post-Unreal, you need to pnd a way to do it, but from my seat, I'm telling 
you have done the complex, hard, huge, and long part; what comes next Is a lot 
simpler! 


By the end of this chapter, you will be able to: 


Å Prepare your project to makea building 

Set different build settings to match the build requirements 
Add different videos and splash screens to your game 
Package the game into an executable 

Cook the game content 


Understand and use Unreal's Project Launcher, patching the project and 
creating DLCs (downloadable content) 


> To > >œ To 
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With all these interesting plans in mind, let's run the editor for one last time, and 
start packaging our game. 


Preparing the project for building 


Remember in Chapter 1, Preparing for a Big Project, when we went to Project Settings 
to do some tweaks? That was something we did at the beginning of the project and 
it will save us some time now. 


There at the Project Settings section are tons and tons of settings, some of which are 
needed during the development time, and while building and editing the game, and 
during the bnal build. 


Feel free to tweak the game as you wish, the physics, the inputs, the navigation, the 
Al, and so on, These types of settings vary between the different types of game. But 
in general there are certain settings that need to be changed for builds, and they are 
almost always the same. 


Packaging settings 

The most important part is to depne what type of build you are making. Many of 
the engine parts will be dependent on that, lots of optimizations will or will not be 
applied based on that. So you have to depne if a regular test build or a þnal build 
needs to be released. 


In order to quickly set this value, Unreal provides you with a quick access for it. 
From the File menu, you can choose either D evelopment or Shipping, from the 
Build Conbguration, under the Package Project submenu: 


DebugGame 


® Development 


Packaging Settings... uae 
Supported Platforms... ae 





From the same menu, you can just hit Packaging Settings, and that will take you 
directly to Packaging Settings inside Project Settings. This one is a shortcut as 
well, but usually you can access these setting from the Edit menu, and then Project 
Settings, which will not only take you to Packaging Settings, but also to the entire 
project settings. 


So feel free to use it the way you want to, but here at Packaging Settings are the 
most important options we can tweak for the build: 
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“J W Android 
Refresh Visual Studio Project e! HTML5 


Open Visual Studio g! 05 


Cook Content for Windows Linux 
Kaiia Windows 
kE Zip Up Project 
Export All... - - l 
aes Build Configuration + 


Add gameLevel to Favorites 
Supported Platforms... 





Packaging Settings contains lots of options affecting the game and its performance 
in different ways. While lots of project settings might remain untouchable from the 
moment you create a project to the moment you ship it, the options and settings 
within this section must be changed and/ or tweaked at least once during the project 
lifetime. Because of their importance, | would like to break all of then down: 


Project - Packaging 


| 


Fine tune how your project is pact yr relea: 


(ly These settings are saved in DefaultGame.ini, which is currently writable. 


4 Project 
Build Configuration 
Staging Directory | | 
Full Rebuild 
For Distribution 


Include Debug Files 


4 Packaging 


Use Pak File 

Generate Chunks 

Build Http Chunk Install Data 
Http Chunk Install Data Directory 
Http Chunk Install Data Version 


Include Prerequisites 
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Here is what you can seein this section of the project settings: 


Å Project: This has the following options: 


fe} 


Build Configuration: It reoresents the type of build, and it is the same 
as the value you could change from the File menu (we discussed this 
in the previous section) and based on it, the engine will apply some 
optimizations and remove some unnecessary code and systems. 


Staging Directory: It represents the directory where the final 
packaged project will remain; in other words, it's where you 
to put the final game! 


Full rebuild: It's a Boolean value; setting ittot rue will force the 
project to make a full build, which will delete the old build, and 
replace it entirely with a new build. But setting this valuetof alse 
means that every time you make a new build, some of the old files will 
not be replaced, and only the files and assets that have changed will 

be updated and replaced with new ones, which means less building 
time. So you have to decide which to go with. Personally, | like to keep 
itfal se aSlong as l'm making testing and development builds, but | 
do switch it tot rue when I'm making the final RC (release candidate) 
builds or the release build itself. Or perhaps switching it tot rue, when 
| find the game is acting weird, as conflicts might happen sometimes! 


For Distribution: It is almost the same as the first option, where you 
have to define if the build is development or shipping, and l've no 
clue why Epic duplicated this choice, once in the form of a Boolean 
and another time in the form of a drop-down menu. But anyway, 
setting this option, will directly disable the Build Configuration 
option and gray it out. 


Include D ebug Files: It's a Boolean value that is related to 
development builds. Checking this option will allow including the 
debug files into the packaged game. J ust check whether, if you really 
want it, it is going to increase the game size too much, but it will 
increase it, however, and you have to be serious about the game size, 
especially if you are targeting mobiles. 


Å Experimental: This has the following option: 


fe} 


N ative Blueprint Assets: This one is still experimental, so you have 
to use it at your own risk. Enabling this choice will force the engine to 
convert all blueprints into C+ code. This process will take some time 
which means the build time will be a little more, but on the other 
hand the game performance will be better. If you kept it disabled, 
then all the logic made using blueprints will be packaged asuasset 
files into the final packaged game. 
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Å Packaging: This has the following options: 


fe) 


Use Pak File: This is enabled by default and it is better to keep it 
enabled, as this option will make sure to package all the content 
inside one*. pak file, rather than keeping all the content scattered 
into tons of individual files. Those*. pak files are compressed 
formats (just like. zi p ), and they get decompressed when launching 
the game. So you will get a smaller build but start-up time will 
slightly increase (but not too much). 


G enerate Chunks: Enabling this option will work on generating 

. pak file chunks, and it is good for cases where the game is huge and 
needs to be installed from a server (Streaming Installs). The process 
of assigning the assets into specific chunks is usually done either 
through the editor or via delegates in C++ code. 


Chunk Hard References Only: If the previous option was 
enabled, then enabling this one will make sure you pull in the hard 
dependencies of assets into the generated chunk, and all other 
dependencies remain in their original chunks. 


Build Http Chunk Install D ata: Enabling this option will generate 
data for the HTTP chunk installer; then it can be hosted in a web 
server for the user to installs it at runtime. But it also works only if 
you've enabled the G enerate C hucks option. 


Http Chuck Install D ata Directory: The directory where the data will 
be built, only if the previous option was enabled. 


Http Chuck Install D ata Version: A version name or number for the 
HTTP chunk install data. 


Include Prerequisites: Enable this option if you want to include 
prerequisites for packaged games, something like redistributable 
operating system components. 


Now you understand what these options are for, and based on your game, its type, 
and its size, you will be choosing what is to be enabled and what is not needed for 
now. Most importantly, mark your game as Shipping, if it is going to be shipped. 
That will make it more secure with less development content. 
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Maps & Modes settings 


The second and very important section of settings you will probably need to make sure 
of every time you are making anew game build of the game, isthe M aps & M odes 
section, which is accessible directly through Project Settings under the Edit menu: 


| 


roject - Maps & 


l iti ther map rela irig 


pi These settings are saved in DefaultEngine.ini, which is currently writable. 


4 Default Maps 


Game Default Map | /Game/Maps/gameLevel | Ez 
Editor Startup Map /Game/Maps/gameLevel | +. 


4 Local Multiplayer 
Use Splitscreen 
Two Player Splitscreen Layout Horizontal ¥ 
Three Player Splitscreen Layout 


4 Default Modes 


Default GameMode BellzGameMode ~*~. O + 


> Selected GameMode 


4 Game Instance 


Game Instance Class Gamelnstance "E een. 





Usually any game made with Unreal Engine, or any similar technology, has lots of 
maps and levels but, when you build the game, how does the engine Know which one 
Should be launched prst, or which one is the most important? H ere within this section 
you have the chance to set these settings, and depne what map needs to be launched 
brst; then, using the game code, you can usethis map to start launching all the other 
maps, but you need to pass only the prst map to the engine during the packaging time. 
Herein the M aps & Modes settings there is a set of options that you might need to 
change or might not need to check at all however, in general, the Game D efault M ap 
is a necessary beld you must check when you are making the build. 
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You can also do the following for your game from this section: 


Å Default Maps: This has the following options: 


° Game Default M ap: Which map is to be used as the default map that 
will be run directly after the splash screen 


° Editor Startup M ap: Define which map should be the default map 
that the editor has to load every time you run the editor 


Å Local Multiplayer: This has the following options: 


° Use Splitscreen: If the game has more than one local player, does 
the screen have to be split, or will all the player will be playing on 
one screen? 


° Two Player Splitscreen Layout: If the game is a multiplier with 
the previous option checked, then how would you liketo divide 
the screen between two players? Vertically or horizontally: 
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fe} 


Three Player Splitscreen Layout: In a multiplayer that has the Use 
Splitscreen options selected, if there are three active players, then the 
screen will be split between them in a different way. As there must 
be one player who has the advantage of a full half of the screen. This 
option allows you to decide if that full half is on the top or the bottom 
of the screen: 





Å Default M odes: this has the following options: 


fe) 


D efault GameM ode: As we discussed in Chapter 1, Preparing for a Big 
Project, the importance of the game mode. We discussed in Chapter 2, 
Setting U p Your Warrior, how to define settings for it. You have to set 
the default game mode, from this section of Project Settings. 


Selected GameM ode: As the game mode is a set of settings, in this 
section you can set the different values for the game mode, such as 
the default pawn controller or the default HUD. 


A Game Instances: This has the following options: 


fe} 


Game Instance Class: A drop-down list to select the class to use 
when instantiating the transient Gamel nst ance class 
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Description settings 


There are some game settings that you have to set, but no one will see them after you 
(I mean the players). The type of setting you need to change in this case is the game 
description. This set of settings you probably will change only once, at the prst time 
you make the prst build. The settings here remain almost the same with your game 
consistence, but you are free to change the settings here every time you make a build: 


Project - Description 


Bh These settings are saved in DefaultGame.ini, whichis currently writable, 


4 Publisher 


Company Name mamoniem 


Company Distinguished Name mamoniem 
Homepage http: www. mamoniem.com 
Support Contact muhammadimameoniem.com | 


a About 
Project Thumbnail 


Description Bellz, a 3rd person action gamed made in C++ and Unreal4.10 


project D GA267E52-4429-861F 35ESESOZSATFOTAA) | 
Project Name 
Project Version 

4 Legal 
Copyright Notice | All rights reserved, Muhammad A. Moniem 2016 http: 
Licensing Terms 
Privacy Policy 

4 Displayed 


Project Displayed Title 
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I'll not go through the settings you pnd in the section, as they are self-explanatory 
and will most probably not be seen by the user. You have to put in your company 
name, game name, website, build version, copyrights, and display title, and so on. 
But the most important option here is the Project Thumbnail, which will be used to 
display the game in the Unreal Launcher only. You have to make sure that you use 
a 192 by 192 pixel image for that. And remember, this is not representing the game 
icon that the players will see. 


Platform settings 


As you still inside Project Settings, you'll have a huge section of them called 
Platforms. This section might vary for your editor version. As for me, I'm using 
Windows. | have access to lots of platforms but, for example, if you are running 
Unreal Engine on Mac or Linux, you'll probably end up with a shorter list of 
platforms. This list contains only the platforms that you can target from your 
current OS: 


Platforms 


Android 





While l'm using Windows and we are targeting Windows and the console, I'll be 
discussing in this section the Windows platform options that you can set. Feel free to 
explore all the other settings for the other platforms. But keep in mind that, while our 
game Is targeting console quality, we still can't set the platform settings for XBox or 
PlayStation as this section of settings is locked until you get authorized by Microsoft 
or Sony and get the DevKit from them that will unlock the platform options for you 
inside Unreal Engine. Anyway, the options that we can set for the Windows platform 
are the following: 
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Platforms - Windows 


bs These settings are saved in DefaultEngine.ini, which is currently writable 


4 Targeted RHis 
DirectX 11 (SM5) 
DirectX 10 (SM4) 


OpenGL 3 (5M4) 


Saas 


OpenGL 4 (SM5, Experimental) 


40S Info 


4 Splash 


Editor Splash 


Game Splash 


Game Icon 





Å Targeted RHIs: This has the following options: 


° DirectX 11 (SM 5): Check it tot rue tf you want the game to support 
DirectX 11 features with Shader Model 5. 


° DirectX 10 (SM 4): Check it tot rue if you want the game to support 
DirectX 10 features with Shader Model 4. 
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° OpenGL 3 (SM 4): Check it tot rue if you want the game to support 
the OpenGL 3 features with Shader M ode! 4. 


° OpenGL 4(SM5): Check it tot rue if you want the game to support 
the OpenGL 4 features with Shader Mode! 5. But this one is still 
experimental. 


Å OS Info: This has the following option: 


° Minimum OS Version: This option will probably be disabled if you 
have got the Unreal editor as a downloaded version. But if you got 
the Unreal editor source code, and you compile it in Visual Studio, 
then you can define which OS version is to be used. But anyway, 
Epic set it to Vista, which is good and a standard now. If you want 
to support lower versions, or unsupported Vista, then you have to 
compile the engine from the source code. 


Å Splash: This section has the following options: 


° Editor Splash: When you run the editor, there is small square splash 
screen with some information and text above it; it's called the project 
splash. H ere you can define this image, make sure that it is in the 
* BMP format and its size is almost 600 by 200 pixels. 


° Game Splash: The same as the editor splash screen, but this one is 
displayed after the player clicks the game icon and before the game 
launches, while the engine is starting. This must also be 600 by 200 
pixels in the*. BMP format. 


Å Icon: This has the following options: 


° Game Icon: Here you can choose the game icon, the one that the 
player will be seeing when they want to run the game, and probably 
the same one that you will be using for the store. Make sure that this 
icon is in the file extension *. i co as that's the official icon extension 
for Windows. Also make sure that its size is 256 by 256 pixels. 


Now while everything is almost in place, and we are ready to go, let's just change 
one more setting in Project Settings. 
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Adding different screens 


A game may be not made by one company, and there should be a publisher and 
developer at least. Both of them may want to include their fancy logos as splash 
screens at the beginning of the game. Usually agame by default will include only the 
Unreal Engine logo at the beginning of it, and before launching any of the maps. But 
Unreal Engine gives you the choice to add any amount of splash screens in the form 
of videos, but all come after the Unreal Engine logo. 


The splash screen or movie set of options that is provided by the Unreal Engine can 
be found under Project Settings, but this time within the M ovies section. And these 
options include the following: 


Å Movies: This has the following options: 


° Wait for M ovies to Complete: Setting this option tot rue, the game 
will wait for all the movies to be completed, and then run the game, 
even if the game loading has already completed. 


° Movies Are Skippable: Setting this option tot rue will allow the 
player to skip the start-up movies when they do inputs such as a 
mouse click for example. It is good to have this option, but usually 
the splash screen should not be skippable. 


Å Startup M ovies: This is an array of dements, which means you have to 
define anumber of movies you want to display, and the order in which 
you select the files inside the array will bethe same order to display those 
movies. The most important part about this option is that you need to set 
these movies files within the Cont ent folder in a folder named Movi es: 


Project - Movies 


Movie player settings 


fe These settings are saved in DefaultGame. ini, which is currently writable. 


4 Movies 


Wait for Movies to Complete |_| 


Movies Are Skippable |_| 


> Startup Movies lelements —- gj 
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Set the ones you need to display, and mark the options you want to be true, and now 
you are really ready to export the game and run it. And that's what we are going to 
do next. 


Packaging the game 

Now when it comes to packaging the game process, | have to say it is the easiest and 
straightforward thing to do in this chapter. And while it is just a click of a button, 
sometimes it becomes a nightmare for people when packaging fails and errors 

start to show up. You can apply the packaging of the project to a certain platform, 
from the File menu, and then choose Package Project and then select your targeted 
platform, and that will start packaging right away: 


W. New Project... 


W Open Project... 

W New C++ Class... 

‘i | W Android 

Refresh Visual Studio Project B! HTML5 

Open Visual Studio @! 10S 

Cook Content for Windows a Linux 
Actors Windows (32-bit) 
ohh pats Zip Up Project is 
Export All... 
ee R Build Configuration + 


Add gameLevel to Favorites Packaging settings. 





Supported Platforms... 


While the game is packaging, it is actually doing three different processes one after 
another, which are: 


1. Build the project. 
2. Cook the content. 
3. Package the game. 


During all that time all that you can do is just wait until it is done. As you can see, once 
the packaging starts, you'll see the progress bar at the top-right corner of the screen: 


., Packaging project for Windows (64-bit)... 





Cancel 
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Personally, | like to hit the Show Output Log button, and watch it while packaging 
the project. It is not just informational; you can learn about the process of packaging 
your game and how Unreal Engine does it, the problems your game might have; 
most importantly, if the packaging process failed, this log screen will display as 
much information to you as possible, enough to lead you in the correct direction 
towards þxing it. And even if the failure does not show a clear error that you need 
to bx, you'll at least know at which phase the packaging process failed, and that's 
enough to bx it or ask for help from the Epic staff: 


æ Packaging complete! y 





Once the packaging is done and successful message appears, you can pnd the game 
in the depned directory where you have depnes, and from there you can launch the 
game using its executables. The executable extension and place might vary between 
the different platforms. 


Cooking the content 


Previously when we discussed the packaging process, I've mentioned that it happens 
in different phases, and one of those phases is called cooking the content. When it 
comes to packaging a game, Unreal is very smart and they thinks about how to make 
the best of your time as a developer. 


Let's assume that you have made a huge game, about 10 GB in size. What if you have 
changed a single texture? Do you have to build the whole thing in order to test it? Or 
do you have to build the whole thing in order to publish it? 


Unreal does a good separation between the game logic and its content, and as long as 
you want to rebuild the content itself, you can always do it by cooking. Content such 
as textures or sound ples always have their own ble formats, like PNG, JPG, WAV, 

or MP3, but when you package the game, you never pnd those ples, as the engine 
works on converting those ples to more encrypted and engine-friendly formats that 
match the targeted platforms. And that's called the cooking content process. 
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You can cook the project content at any time from the File menu, choosing C ook 
Content for Windows: 


RR New Project... 


Open Project... 
© New C++ Class... 
E Package Project 


Generate Visual Studio Project 





Project Launcher and DLCs 


The prst and the most important thing you have to keep in mind is that the project 
launcher is still in development and the process of creating DLCs is not pnal yet, and 
might get changed in the future with upcoming engine releases. While writing this 
book I've been using Unreal 4.10 and testing everything | do and write within the 
Unreal 4.11 preview version, and yet still the DLC process remains experimental. So 
be advised that you might pnd it a little different in the future as the engine evolves: 


Te Siew 
MR Projcetheinenier 


Project Ye Advanced 


Z All_iOS_On_DESKTOP-8S5GMJ9 
@ .: 


Firefox ea] 
5 S 
HTML5 ~S 
Launch 
DESKTOP-8S5GMJ9 VENENE Default ~ xr" 
+ 


WindowsNoEditor 
Launch 


Custom Launch Profiles 
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While we have packaged the game previously through the File menu using 
Packaging Project, there is another, more detailed, more professional way to do the 
same job. Using the Project Launcher, which comes in the form of a separate app 
with Unreal (Unreal Frontend), you have the choice to run it directly from the editor. 
You can access the Project Launcher from the Windows menu, and then choose 
Project Launcher, and that will launch it right away. 


However, | havea question here. 


Why would you go through these extra steps, then just do the packaging process In 
one click? 


Well, extensibility is the answer. Using the Unreal Project Launcher allows you to 
create several probles, each proble having a different build setting, and later you can 
bre each build whenever you need it; not only that, but the proples could be made 
for different projects, which means you can have an already made setup for all your 
projects with all the different build conbgurations. 


And yet even that's not everything; it comes in handier when you get the chance to 
cook the content of a game several times, so rather than keep doing it through the 
File menu, you can just cook the content for the game for all the different platforms 
at once. For example; if you have to change one texture within your game which 

IS Supported on pve platforms, you can make a prople which will cook the content 
for all the platforms and arrange them for you at once, and you can spend that time 
doing something else. The Project Launcher does the whole thing for you. 


What if you have to cook the game content for different languages? Let's say the 
game supports 10 languages? Do you have to do it one by one for each language? 


The answer is simple; the Project Launcher will do it for you. 


So you can simply think of the Project Launcher as a batch process, custom 
command-line tool, or even a form of build server. You set the conbgurations and 
requests, and leave it alone doing the whole thing for you, while you are saving 
your time doing something else. It is all about productivity! 


And the most important part about the Project Launcher is that you can create 
DLCs very easily. By just setting a prople for it with a different set of options and 
settings, you can end up with getting the DLC or game mode done without any 
complications. In a word, it is all about probles, and because of that let's discuss 
how to create proples, that could serve different purposes. 


Sometimes the Project Launcher proposes for you a standard prople that matching 
the platform you are using. That is good, but usually those proples might not have 
all we need, and that's why it is recommended to always create new proples to serve 
our goals. 
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The Project Launcher by default is divided into two sections vertically; the upper 
part contains the default proples, while the lower part contains the custom proples. 
And in order to create a new proble all you have to do isto hit the plus sign at the 
bottom part, where it is titled Custom Launch Proples: 


Custom Launch Profiles 





Pressing it will take you to a wizard, or it is better to describe this as a window, 
where you can set up the new proble options. Those options are drastic, and 
changing between them leads to a completely different result, so you have to be 
careful. But in general, you mostly will be building either a project for release, or 
building aDLC or patch for an already released project. N ot to mention that you 

can even do more types of building that serve different goals, such as a language 
package for an already released game, which is treated as a patch or DLC but at the 
same time it has different a setup and options than a patch or DLC. Anyway, we will 
be taking care of the two main types of process that developers usually have to deal 
with in the Project Launcher: release and patch. 


Packaging a release 

After the new Custom Launch Prople wizard window opens, you have changes for 

its settings that are necessary to make our Release build of the project. This includes: 
Å General: This has the following fields: 


° Giveanameto the profile, and this name will be displayed in the 
Project Launcher main window 


° Givea description to the profile in order to make its goals clear for 
you in the future, or for anyone else who is going to use it 


WwW Windows 64 Full language 


The build for Bells (or anyother project) as an initial build, with a support for all the language packs 
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Å Project: This has the following sections: 


° Select a project, the one that needs to be built. Or you can leave this at 
Any Project, in order to build the current active project: 


Project Which project would you like to use? 


eye Any Projectv 





Å Build: This has the following sections: 


° Indeed, you have to check the box of the build, so you make a build 
and activate this section of options. 


° From the Build Configuration dropdown, you have to choose a build 
type, which is Shipping in this case. 


° Finally, you can check the Build UAT (Unreal Automation Tool) 
option from Advanced Settings in this section. The UAT could 
be considered as a bunch of scripts creating a set of automated 
processes, but in order to decide whether to run it or not, you have 
to really understand what the UAT is: 


° Written in C#(may convert to C++ in the future) 

° Automates repetitive tasks through automation scripts 

° Builds, cooks, packages, deploys and launches projects 

° Invokes UBT for compilation 

° Analyzes and fixes game content files 

° Codes surgery when updating to new engine versions 

° — Distributes compilation (XGE) and build system integration 
° Generates code documentation 

° Automates testing of code and content 

° And many others—you can add your own scripts! 


Now you will know if you want to enable it or not: 


Do you wish to build? 


Build Configuration: | Shipping ~ | 


4 Advanced Settings 


Build UAT 





['56; "] 


Packaging theGame 


Å Cook: This has the following settings: 


° Inthe Cook section, you need to set it to by the book. This means you 
need to define what exactly is needed to be cooked and for which 
platforms it is enough for now to set it to WindowsN oEditor, and 
check the cultures you want from the list. | have chosen all of them 
(this is faster than picking one at a time) and then exclude the ones 
that | don't want: 


How would you like to cook the content? 


Cooked Platforms: 
Ø AllDesktop 
WindowsClient 
WindowsNoEditor 
@ WindowsServer 
Windows 
EOE 

Ø Android_ASTC 
@ Android_ATC 
Ø Android_DxXT 
Ø Android_ETc1 
Ø Android_ETc2 


Select: All None 


Cooked Cultures: 
Ø de 

de-AT 

de-BE 

de-CH 


de-L| 
de-LU 
en 
en-001 
en-150 
en-AG 


Select: All None 





° Then you need to check which maps should be cooked; if you can't 
see maps, it is probably the first build. Later you'll find the maps 
listed. But anyway, you must keep all the maps listed in the Maps 
folder under theCont ent directory: 


Cooked Maps: 
è Show all Show cooked 


© No available maps were found. 
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° Now from the Release / DLC / Patching Settings section, you 
have to check the option Create a release version of the game for 
distribution, as this version going to be the distribution one. 


° And from the same section give the build aversion. This is going to 
create some extra files that will be used in the future if we are going 
to create patches or DLCs: 


a Release / DLC / Patching Settings 


Create a release version of the game for distribution. 


Name of the new release to create. 
1.0 


Release version this is based on. 
B Generate patch 
Ø Build DLE 


Name of the DLC to build. 


®@ Include engine content 





° You can expand the Advanced Settings section to set your own 
options. By default, Compress Content and Save Packages without 
versions are both checked, and both are good for the type of build 
we are making. But also you can set Store all content in a single file 
(UnrealPak) to keep things tidy; one. pak file is better than lots of 
separated files. 


° Finally, you can set Cooker Build Configuration to Shipping, as 
long as we set Build Configuration itself to Shipping: 


a Advanced Settings 


Only cook modified content 
Compress content 
Save packages without versions 


Num cookers to spawn: 


Store all content in a single file (UnrealPak) 


W Generate Chunks 
E Dort Include editor content in the build 
t Http Chunk Install Settings 


Cooker build configuration: 
Shipping r 


Additional Cooker Options: 
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Å Package: This has the following options: 


° From this section's drop-down menu, choose Package & store 
locally, and that will save the packages on the drive. You can't set 
anything else here, unless you want to store the game packaged 
project into a repository: 


Package How would you like to package the build? Package & store locally » 


Repository Path: 


Description: 


p Incremental Packaging 





Å Deploy: The Deploy section is meant to build the game into the device of 
your choice, and | don't think it is the case here, or anyone will want to do it. 
If you want to put the game into a device, you could directly do Launch from 
within the editor itself. So, let's set this section to Do Not Deploy: 


How would you like to deploy the build? Copy to device » 


Device Variant Platform Host Owner 


E All_iOS_On_DESKTOP-8S5GMJ9 Standard IOS DESKTOP-8S5GM Muhammad 


5 Firefox Standard HTML5 DESKTOP-8S5GM Muhammad 
Bs DESKTOP-8S5GMJ9 WindowsNoEditor DESKTOP-8S5GM Muhammad 


p Advanced Settings 





Å Launch: In case you have chosen to deploy the game into a device, then 
you'll be able to find this section; otherwise, the options here will be disabled. 
The set of options here is meant to choose the configurations of the deployed 
build, as once it is deployed to the device it will run. Here you can set 
something like the language culture, the default startup map, command-line 
arguments, and so on. And as we are not deploying now, this section will 
be disabled: 
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Launch How would you like to launch? Using default rolew 


4 Default Role 


Launch As: 


Standalone Client X 


Initial Culture: 


Initial Map: 


Additional Command Line Parameters: 


Ø Synchronize Screen Refresh Rate (VSync) 





Now we have pnished editing our proble, you can pnd a back arrow at the top of 
this wizard. Pressing it will take you back to the Project Launcher main window: 





Now you can pnd our proble in the bottom section. Any other proples you'll be 
making in the future will be listed there. Now there is one step to pnish the build. 

In the right corner of the prople there is a button that says Launch This Prople. 
Hitting it will start the process of building, cooking, and packaging this prople for 
the selected project. Hit it right away if you want the process to start. And keep in 
mind, anytime you need to change any of the previously set settings, there is always 
an Edit button for each prople: 


Ww Windows 64 Full language 


The build for Bells (or anyother project) as an initial build, with a support for all the language packs 
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The Project Launcher will start processing this prople; it will take some time, but the 
amount of time depends on your choices. And you'll be able to see all the steps while 
it is happening. Not only this, but you can also watch a detailed log; you can save 
this log, or you can even cancel the process at any time: 


Operation in progress... 
el 


BETS Duration Status 
Verify profile settings 0:00:00 Completed 
Launching UAT... 0:00:02 Completed 


Starting cook on the fly server 0:00:05 Completed 
Deploying content for Win64 0:00:11 Completed 
Launching on "WindowsNoEditor@DESKTOP-8S5GMJ9" 0:00:01 Busy 

UAT post launch cleanup Pending 





Once everything is done, a new button will appear at the bottom: D one. Hitting 
it will take you back again to the Project Launcher main window. And you can 
easily pnd the build in theSaved\ StagedBuilds\ Wi ndowsNoEditor directory of 
your project, which isin my case: C:\ Users\ Muhammad\ Desktop\Bellz\Saved\ 
StagedBullds\WindowsNoEditor. 


The most important thing now is that, if you are planning to create patches or 
DLCs for this project, remember when you set a version number in the Cook 
section. This produced some ples that you can pnd in: Proj ect Name\ Rel ease\ 
ReleaseVersion\ Platform. Which in my casels: C:\ Users\ Muhammad\ Deskt op\ 
Bell z\Releases\1.0\WindowsNoEditor. 


There are two bles; you have to make sure that you have a backup of them on your 
drive for future use. 


Now you can ship the game and upload it to the distribution channa! 


Packaging a patch or DLC 


The good news is, there isn't much to do here. Or in other words, you have to do 
lots of things, but it is a repetitive process. You'll be creating a new proplein the 
Project Launcher, and you'll be setting 90% of the options so they're the same as 
the previous release prople; the only difference will bein the Cook options. Which 
means the settings that will remain the same are: 


Å Project 
Å Build 
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Å Package 

Å Deploy 

Å Launch 
The only difference is that in the Release/D LC /Patching Settings section of the Cook 
section you have to: 

1. Disable Create a release version of the game for distribution. 


2. Set the number of the base build (the release) as the release version this is 
based on, as this choice will make sure to compare the previous content 
with the current one. 


3. Check Generate patch, if the current build is a patch, not a DLC. 
Check Build DLC, if the current build is a DLC, not a patch: 


a Release / DLC / Patching Settings 


Ø Create a release version of the game for distribution. 


Name of the new release to create. 


Release version this is based on. 


Generate patch 
Ø Build Lc 
Name of the DLC to build. 


W Include engine content 


c Advanced Settings 





Now you can launch this prople, and wait until itis done. The patching process creates 
a*. pak plein thedirectory: Proj ect Name\ Saved\StagedBuilds\ Pl atformName\ 
Proj ectName\ Content \ Paks. 


This. pak pleis the patch that you'll be uploading to the distribution channel! And 
the most common way to handle these type of patch is by creating installers; in 
this case, you'll create an installer to copy the*. pak pleinto the player's directory: 
Proj ectName\ Rel eases\ Versi onNumber\ Pl atformName\. 


Which means, it is where the original content *. pak ple of the release version is. 


In my case | copy the*. pak plefrom: C:\ Users\ Muhammad\ Deskt op\ Bel | z\ 
Releases\1.0\WindowsNoEditor to: C:\Users\ Muhammad\ Desktop\ Bel! z\Saved\ 
StagedBul l ds\ Wi ndowsNoEditor\Bellz\Content\ Paks. 
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Now you've found the way to patch and download content, and you have to know, 
regardless of the time you have spent creating it, it will be faster in the future, 
because you'll be getting more used to it, and Epic is working on making the 
process better and better. 


Summary 


For the prst time, you can run the project as a game, not from within the Unreal 
editor or the Unreal Launcher, but as a game from its own executable ple. 


Now you have got you hands-on the process of pnalizing a game as a product, what 
is needed before making the build, and what settings should or could be pne-tuned 
for that purpose? 


All games have different splash screens, based on the number of developers and 
publishers. You will need different types and numbers of splash screens, and 
you've learned during this chapter how to add splash screens to your game in 
different ways. 


Packaging a game and cooking its content are two different processes, but both do 
similar things. You've learned when to use each process, and what the difference is 
between them. 


The Project Launcher is a very powerful tool shipped with the Unreal ecosystem. 
Using it is not mandatory, but sometimes it is needed to save time, and you learned 
how and when to use this powerful tool. 


Many games nowadays have downloadable content; it helps to keep the game 
community growing, and the game earn more revenue. Having DLCs is not 
essential, but it is good, having them must be planned earlier as we discussed, and 
you've learned how to manage them within Unreal Engine. And you learned how 
to make patches and DLCs using the Unreal Project Launcher. 


Now all | can say is thank you for following along. N ow, it's your time go ahead and 
play your game, share it with you friends, receive their feedback, bx it, and make 
another build. And most importantly, if you are happy with your project, don't 
forget to recommend this book to your friends, 
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* sav ble 261 
A 


action mapping 12 
Al 94, 95 
Al assets 
about 95 
Behavior Tree asset 95, 96 
Blackboard asset 98 
BTService 97 
BT Task 96 
ambient occlusion (AO) 
about 185, 186 
settings 187 
animated fog 
about 228 
cinematic, saving as video 229, 230 
color 228 
exponential height fog, animating 228 
animation assets, character controller 
about 56 
animation blueprint 60-67 
blend space, creating 58, 59 
sockets, adding to skeleton 56-58 
animation blueprint 99-103 
animations 
about 243 
adding, to UI 243, 245 
art of level design 
about 74 
assets, placing into world 75-77 


Index 


brushes, using for enhancing 
level design 78, 79 
lights, adding to level 80-83 
Atmospheric Fog 
about 207 
adding 207, 208 
audio bles 
Importing 288-293 
audio volumes 302, 303 
axis mapping 12, 13 
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base class, collectable 
about 135 
PickupBase.copp 137, 138 
PickupBase.h 135-137 
behavior tree 
about 121 
blackboard 121 
building 121-125 
Bellz cinematic 222-227 
Binding Keys 12 
blueprint, collectable 
building 143, 144 
blueprint data structure 271, 272 
blueprint debugger 308-311 
blueprints 
creating 125-128 
game data, loading 262-265 
game data, saving 262-265 
box shape 206 
BSP 78 
BTService 122 
BTTask 123 
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C++ 
game data, loading 259-261 
game data, saving 259-261 
C++ data structure 
about 273, 274 
GameDataTables.cop 277, 278 
GameDataTables.h 274-276 
C++ game 
overview 2 
character controller, setting up 
animation assets 56 
blueprint, adding to GameMode 70, 71 
blueprint, building 68-70 
C++ class, creating 27-30 
code, adding 31, 32 
code, compiling 54, 55 
code, editing 31, 32 
code project 26 
Gladiator header (.h) ple 33 
Gladiator source (.cpp) ple 39 
cinematic actor 214 
cinematics 213 
C++ logic 
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EnemyA|Controller class 104, 105 
Enemy class 103 
coin class, collectable 
about 139 
CoinPickup.cpp 140 
CoinPickup.h 139, 140 
collectable 
adding 133 
blueprint, building 143, 144 
making 141-143 
overview 134, 135 
Collision Analyzer 
about 311 
using 311-313 
console 313, 314 
content 
cooking 345 
C++ project 
animations, retargeting 18-22 
assets, migrating 14-16 
creating 3-6 


editor settings 8-10 
inputs, mapping 10-14 
MarketPlace assets, using 16-18 
project directory 5 
project settings 6-8 
Curve Editor 
about 169-172 
areas 170 
curve, adding to graph 177 
curve, removing from graph 177 
curves, organizing 176 
Interpolation modes 173-176 
organizing, with tabs 177 
cutscenes 213 
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data structure 

creating 271 
data tables 

reading from 281 

reading, through blueprints 284, 285 

reading, through C++ 281-283 
data table sheet 

about 268, 269 

creating 269, 270 
Depth Of Field (DOF) visualizer 321 
Description settings 339, 340 
details panel 

about 159-161 

particle emitter 166 

particle modules 168 

particlesystem 161 
Device Manager 324, 325 
Device Probles 326-328 
different screens 

adding 343 
DLCs 

about 346, 347 

packaging 354, 355 
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emitters panel 
about 154-156 
modules, adding 157, 158 
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Enemy 

about 112 

Enemy.cop 115-120 

Enemy.h 112-115 
EnemyA!Controller 

about 105 

EnemyA!Controller.cop 107-112 

EnemyA|Controller.n 105-107 
Exponential Height Fog 

about 209 

adding 210, 211 
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fog effects 
about 206 
Atmospheric Fog 207 
Exponential Height Fog 209 
FPS charts 314-316 


G 


game 
packaging 344, 345 
game data 
loading, in blueprints 262-265 
loading, in C+ 259-261 
saving, in blueprints 262-265 
saving, in C++ 259-261 
Game D esign Document (GDD) 94 
game logic 
UI, connecting with 245-251 
game UI 
implementing 231 
game UI widget 235 
Gladiator header (.h) þle 
about 33 
AGladiator 34 
AttackRange 38 
BaseLookU pRate 35 
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BeginPlay 33 
CameraBoom 34 
EffectSprite 34 
FollowCamera 34 
GetCameraBoom 37 


GetFollowCamera 37 
GetlsStillA live 36 
IsAttacking 35 
IsControlable 36 
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Jump 37 
JumpingVelocity 35 
LookUpAtRate 38 
MoveForward 37 
MoveRight 37 

OnAttack 38 
OnChangeH ealthByA mount 36 
OnChangeWeapon 38 
OnGetH ealthA mount 36 
OnPostAttack 37 
OnSetPlayerController 36 
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Public 39 
SetupPlayerInputComponent 39 
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UFUNCTION 39 
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about 39 

BeginPlay 44, 45 
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Includes 39 

jump function 47 
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MoveRight 53, 54 

OnAttack 48 

OnChangeH ealthByA mount 51, 52 
OnChangeWeapon 49 
OnPostAttack 48 
OnSetPlayerController 51 
SetupPlayerlnputComponent 45, 46 
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inputs, C ++ project 
action mapping 12 
Android 11 

axis mapping 12 
gamepad 11 
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keyboard 11 

motion controllers 11 
mouse 11 

steam 11 

Xbox One 11 
interpolation modes, Curve Editor 
Auto 173 

Auto Clamped 174 
Break 175 

Constant 176 

Linear 175 

User 174 


K 
keys 172 
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level 

art of level design 74 
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lightmaps, building 84, 85 
water surfaces, creating 85 
level design process 
reference 74 
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lightmass 
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Importance volume settings 190-195 
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navigation mesh 89-91 
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particle emitter, details panel 
about 166 
Cascade 167 
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particle modules, details panel 
about 168 
Cascade options 168 
particles 
spawning 178-180 
particles editor 148, 149 
particle system, details panel 
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delay 164 
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Macro UV 164 
materials 166 
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patch 
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Platform settings 340- 342 
Player Start 87-89 
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post process project settings 
about 196 
available effects 201, 202 
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post process volume settings 

properties 199, 200 
project 

preparing, for building 332 
project directory, C ++ project 

Binaries 5 

Build 5 

Conbg 5 

Content 5 

Intermediate 5 

PNGImage 5 

Saved 5 

Source 5 

SQLFile 5 

Unreal Engine Project 6 

Visual Studio solution 6 
Project Launcher 346, 347 
project settings 334, 335 
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Constructor 32 
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about 202-204 
actors 205 
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packaging 348-354 
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building 256-258 
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show yags 313 
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about 293, 294 
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sound cue editor 299, 300 
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playing, through C++code 303 
playing, through drag and drop 305 
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Third Person Game template 85 
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UI 
animations, adding 243-245 
connecting, with game logic 245-251 
constructing 239-243 
UI widgets 235 
UMG (Unreal M otion Graphics) 
about 232 
as Unreal's UI system 232, 234 
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about 232, 236 
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view modes 

about 316 

Lightmap Density 319 

Light Only 318 

Reyections 319 

Unlit 317 

Wireframe 318 
viewport panel 

about 151 

timing options 153 

viewing options 151-153 
visualizers 316-321 
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